Alibaba: Wan 2.7
ينشئ Alibaba Wan 2.7 مقاطع فيديو بصوت من النصوص أو الصور الافتتاحية والختامية أو المراجع المرئية. ويتيح مسار الصور فيه أيضًا متابعة مقطع مصدري، باستخدام المدة الإجمالية المطلوبة. يذكر المنتج إخراج MP4 بدقة 720p أو 1080p وبمعدل 30 fps: من 2–15 ثانية لأوضاع النص والصورة، وحتى 10 ثوانٍ للتوليد بالمراجع.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Alibaba Wan 2.7 عائلة لتوليد الفيديو تضم ملفات تعريف مسماة لتحويل النص إلى فيديو والصورة إلى فيديو والتوليد الموجّه بالمراجع. توثّق الجهة المصنّعة مشاهد متزامنة مع الصوت وسردًا متعدد اللقطات، بينما يضيف مسار الصور التوليد من الإطارين الأول والأخير واستكمال فيديو أولي. والناتج المفيد مقطع قصير بصوته، مثل انتقال لمنتج أو قصة موجزة أو استكمال يلائم لقطة موجودة. اختر الوضع وفق المادة المصدرية والتحكّم المطلوب في البداية أو النهاية.
لتحويل النص إلى فيديو، صِف العنصر الرئيسي والمكان والفعل والكاميرا والأسلوب والصوت. ويمكن للوحة القصة تحديد كل لقطة ونطاقها الزمني، بينما يجب أن يذكر توجيه اللقطة الواحدة أن الفعل يظل متصلًا. يتيح دليل توجيه Wan 2.7 للنموذج تفسير بنية اللقطات من الوصف المكتوب بدلًا من استخدام عنصر shot_type الخاص ب2.6. تقبل واجهة النص الحالية توجيهات بالصينية أو الإنجليزية حتى 5,000 حرف، مع توجيه سلبي مستقل حتى 500 حرف؛ ويُقتطع النص الزائد. أبقِ الفعل الأساسي والقيود واضحين ضمن هذا الحد.
يحرّك تحويل صورة الإطار الأول إلى فيديو صورة افتتاحية مقدَّمة. ويحدّد التوليد من الإطارين الأول والأخير نقطة النهاية والحركة الواصلة إليها أيضًا. ويدعم دليل الصور 2.7 مصدرًا صوتيًا موجّهًا إلى جانب تركيبات الإطارات هذه. جهّز نقطتي بداية ونهاية تشتركان في مشهد وعنصر مقصود، وصِف الانتقال بدلًا من مطالبة النموذج بإعادة تفسير الصورتين كمرجعين أسلوبيين غير مترابطين. تقارب المخرجات نسب الصورة الأولى؛ ويتعامل الدليل مع الدقة باعتبارها فئة لعدد البكسلات ويقرّب الأبعاد المرمَّزة بما يلائم ذلك.
يبدأ استكمال الفيديو بمقطع مصدري، ويمكنه أيضًا استخدام صورة ختامية. والمدة المطلوبة هي إجمالي الفيديو الناتج، بما فيه الجزء الأصلي. يجمع مثال الدليل مصدرًا مدته ثانيتان وعشر ثوانٍ من المحتوى الجديد في نتيجة مدتها اثنتا عشرة ثانية. جهّز الفعل الأخير في المصدر وحدّد ما يحدث بعده، كي تواصل الكاميرا والعنصر الرئيسي في اتجاه مترابط. راجع الوصلة من حيث المظهر والحركة والضوء والصوت بدلًا من تقييم النهاية الجديدة وحدها.
يستخدم ملف المراجع المستقل الحالي لدى الجهة المطوّرة صورًا أو فيديو لتوجيه الشخصيات أو الأجسام أو المشهد. ويسمح دليله بما يصل إلى خمس صور وفيديوهات مرجعية في المجموع، ويستخدم تسميات بحسب النوع مثل Image 1 وVideo 1. صِف دور كل مادة والتفاعل المقصود. ولمشهد موجّه بالمراجع، اعرض شخصية من مرجع تحمل جسمًا من مرجع آخر عبر موقع محدّد. يختلف التأطير المرجعي عن التوليد من الإطار الأول: يمكن للتوجيه إنشاء تكوين جديد بدلًا من اشتراط افتتاح الفيديو على صورة ثابتة مقدَّمة بعينها.
للصوت المخصّص في التوليد النصي، الصيغ الموثّقة هي WAV وMP3، بمدة من ثانيتين إلى ثلاثين ثانية وحجم أقصى 15 MB. تحدّد مدة الفيديو المختارة الجزء المستخدم: يُقتطع الصوت الأطول إلى تلك المدة، بينما يترك الصوت الأقصر من الفيديو بقية المقطع صامتة. جهّز المقطع الصوتي الدقيق الذي ينتمي إلى اللقطة واترك مجالًا للفعل البصري المقصود. ومن دون ملف صوتي مقدَّم، تصف الجهة المطوّرة توليد موسيقى خلفية أو مؤثرات ملائمة للمشهد؛ افحص الصوت الفعلي وأي كلام مطلوب مع الصورة.
تذكر مصفوفة النماذج الحالية MP4 بدقة 720p أو 1080p ومعدل 30 إطارًا في الثانية، مع فيديوهات ناتجة من النص أو الصور تتراوح مدتها من ثانيتين إلى خمس عشرة ثانية. ويقتصر ملف المراجع المستقل على ثانيتين إلى عشر ثوانٍ. يوفّر التوليد النصي تأطير 16:9 و9:16 و1:1 و4:3 و3:4. ولمهام التوليد المشروط بالصور قواعدها الخاصة لتقريب نسب المصدر، لذا جهّز اقتصاص المدخلات لوجهتها المقصودة. ولا ينبغي استبدال قواعد مسار الإطارات أو الاستكمال بقاعدة مدة أو أبعاد مأخوذة من ملف المراجع.
مسار الجهة المطوّرة الموثّق غير متزامن: يتتبّع معرّف مهمة المعالجة، وتوفّر النتيجة الناجحة موقع الفيديو. وتُوثَّق النتائج بصلاحية روابط تبلغ أربعًا وعشرين ساعة، لذا احتفظ بالمقطع الفعلي والمواد الإبداعية لمراجعة التحرير. وتتبع خيارات إعادة صياغة التوجيه والعلامة المائية والبذرة الواجهة المختارة. تقول الجهة المطوّرة إن تثبيت البذرة يمكن أن يحسّن قابلية إعادة الإنتاج، لكنه لا يضمن نتيجة مطابقة. قارن الملف الناتج بالتوجيه بدلًا من افتراض أن الإعدادات وحدها تحافظ على كل تفصيل.
مقارنةً بWan 2.6، يضيف دليل الصور 2.7 تحديدًا التحكّم بالإطارين الأول والأخير واستكمال الفيديو عبر مدخلات وسائط متعددة. ويقدّم Wan 3.0 بنية شاملة مختلفة وحدًا أطول للتوليد. يحتفظ ملف 2.7 هذا بعناصر التحكّم والحدود الخاصة بكل مهمة. راجع المشهد كله من حيث استمرارية العنصر الرئيسي ومراسي الإطارات وهوية المراجع والحوار والحركة والوصلات، واجعل التصحيح التالي مرتبطًا بالمشكلة الفعلية التي عُثر عليها.
Ailoot Ultra · فيديو POST /v1/videos alibaba/wan-2.7
alibaba/wan-2.7البداية
ينشئ Alibaba Wan 2.7 مقاطع فيديو بصوت من النصوص أو الصور الافتتاحية والختامية أو المراجع المرئية. ويتيح مسار الصور فيه أيضًا متابعة مقطع مصدري، باستخدام المدة الإجمالية المطلوبة. يذكر المنتج إخراج MP4 بدقة 720p أو 1080p وبمعدل 30 fps: من 2–15 ثانية لأوضاع النص والصورة، وحتى 10 ثوانٍ للتوليد بالمراجع.
- المدخلات المقبولة
- النص
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text- الإخراج
video- صيغة الإخراج
- mp4
- عدد المخرجات
- حتى 4 إخراجs
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود alibaba/wan-2.7 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الحد الأقصى لبايتات UTF-8: 10,000 يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 2, 3, 4, 5, 6, 7, 8, 9, 10 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلبمطلوب | القيم والحدود 720p | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلبمطلوب | القيم والحدود 16:9, 9:16, 1:1, 4:3, 3:4 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلبمطلوب | القيم والحدود false, true | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · مطلوب: prompt
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
المعلمةadditional_properties | المواصفاتfalse |
المعلمةparameters | المواصفات{"name":"model","type":"string","required":true,"enum":["alibaba/wan-2.7"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[2,3,4,5,6,7,8,9,10]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16","1:1","4:3","3:4"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
المعلمةmaterial_types | المواصفاتtext |
الأسماء البديلة للطريقة: /v1/videos/generations, /videos, /videos/generations
دورة الحياة: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
احتفظ بالاستجابة كاملة وبالمعرّفات الأصلية المُعادة.
لا تعِد إرسال طلب إنشاء مجهول النتيجة مطلقاً.
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | خيارات إنشاء الصوت | الدقة | وحدة الفوترة | الرسوم |
|---|---|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | خيارات إنشاء الصوت— | الدقة— | وحدة الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتUltra | جدول التعرفة— | الكمية المتوقعةالإعدادات المطلوبة؛ تقدير فقط. | خيارات إنشاء الصوتمن دون صوت · مع صوت | الدقة720p | وحدة الفوترةلكل ثانية فيديو مُخرج | الرسوم الإخراج · ثانية فيديو تقديرية · تقدير للمقارنة فقط $0.2 لكل ثانية فيديو مُخرج يقدّر السعر المعروض التكلفة قبل التوليد. يُحسب الرسم النهائي من التكلفة المسجَّلة لعملية التوليد الأصلية. مدة الفيديو الفعلية ليست الكمية الخاضعة للفوترة. |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | خيارات إنشاء الصوت— | الدقة— | وحدة الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.4 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر الفيديو $0.2 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
أمثلة للطلبات
Ailoot Ultra · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/wan-2.7", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
استلام النتائج وحفظها
Ailoot Ultra · فيديو
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
التحقق من حالة المهمة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل عنوان URL موقّع ومملوك لك في data[] المكتملة، وبالبيانات الوصفية الكاملة للحالة. احفظ كل مخرج، بما فيه صوته المولَّد. قد يوجد مسار صوتي AAC صالح حتى مع generate_audio=false؛ احتفظ بملف MP4 الأصلي كاملاً، بما فيه ذلك الصوت.
عند الحاجة إلى التحقق من الاستجابة الأصلية
اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.
الحد الأقصى للمخرجات: 4.
حقول الاستجابة
| الحقل | النوع | المعنى |
|---|---|---|
الحقلid | النوعstring | المعنى— |
الحقلobject | النوعstring | المعنى— |
الحقلmodel | النوعstring | المعنى— |
الحقلstatus | النوعstring | المعنى— |
الحقلdata[] | النوعsigned content URL | المعنى— |
الحقلcharge_pending_check | النوعboolean | المعنى— |
الحقلerror.code | النوعstring | المعنى— |
الحقلerror.message | النوعstring | المعنى— |
الحقلoperation_id | النوعstring | المعنىاستجابة الحالة أو المحتوى الأصليين عند HTTP503 result_pending_check: المعرّف العام للفيديو الأصلي نفسه في الحقل id. |
الحقلerror.type | النوعstring | المعنىserver_error عند HTTP503 result_pending_check. |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطتفشل قراءة متن الطلب الخام قبل تحليل ملف إعداد الفيديو | الخطوة التاليةاحتفظ بالاستجابة المُعادة وصحّح متن الطلب الذي تعذرت قراءته. |
الاستجابة422 · price_unavailable | الشرطيتعذر تحليل ملف إعداد الفيديو الدقيق، أو لا تتوفر بطاقة سعر دقيقة وجاهزة لملف الإعداد الكامل بعد تحليله | الخطوة التاليةاحتفظ بالاستجابة؛ واستخدم ملف الإعداد الدقيق المسموح به كاملاً وبطاقة سعره المنشورة. يُنفَّذ هذا الفرع قبل الإرسال إلى المزوّد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
الاستجابة503 · result_pending_check | الشرطGET للحالة أو المحتوى الأصليين: المهمة غير منشورة، والمهمة الأصلية ليست في حالة failed/cancelled/expired، والحالة المحلية unknown أو حالة المهمة الأصلية completed. | الخطوة التاليةاحتفظ بـid وoperation_id الأصليين (المعرّف العام نفسه للفيديو)، وبالاستجابة والترويسات؛ واقرأ الحالة أو المحتوى الأصليين فقط. لا ترسل طلب توليد جديداً مطلقاً. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra alibaba/wan-2.7
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations, /videos, /videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · Alibaba: Wan 2.7
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·alibaba/wan-2.7:text→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·alibaba/wan-2.7:model,prompt,duration,resolution,aspect_ratio,generate_audio