Vidu 1.5
ينشئ Vidu 1.5 الفيديو من prompt نصي بالمعرّف الدقيق vidu-1.5. صِف الموضوع والفعل المرئي وتأطير الكاميرا، ثم اختر مدة خمس ثوانٍ وإحدى ثلاث نسب أبعاد: 16:9 أو 1:1 أو 9:16. أرسل المهمة مرة واحدة وتابع العملية المُعادة حتى تصبح نتيجة الفيديو جاهزة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
يوفّر Vidu 1.5 توليد الفيديو من النص بالمعرّف الدقيق vidu-1.5. ابنِ الطلب حول فكرة بصرية مدتها خمس ثوانٍ: موضوع يؤدي فعلًا واضحًا واحدًا، أو لقطة تأسيسية، أو منتج يُعرض بحركة كاميرا محددة. ضع المشهد والفعل والبيئة والإضاءة والتأطير في prompt النصي حتى توصف اللقطة المقصودة في المادة التي يتلقاها النموذج.
أنشئ الفيديو باستخدام POST /v1/videos وجسم application/json. الحقلان المطلوبان هما model وprompt؛ اضبط model على vidu-1.5 وقدّم وصف اللقطة كسلسلة نصية. يمكن لموجّه مفيد للقطة منتج أن يحدد العنصر والسطح والخلفية وحركة كاميرا واحدة، يتبعها الفعل الذي ينبغي أن يظهر أثناء اللقطة. أبقِ الموجز مركزًا بما يكفي ليُفهم كمقطع قصير واحد.
خيار duration للنموذج هو العدد الصحيح 5، ويمثّل مقطعًا مدته خمس ثوانٍ. قيم aspect_ratio الاختيارية هي السلاسل 16:9 و1:1 و9:16. اختر نسبة تناسب موضع الاستخدام المقصود قبل كتابة التأطير: مشهد واسع لتكوين أفقي، أو ترتيب مركزي لمربع، أو موضوع مرتب عموديًا لتكوين عمودي. يمكن لسلسلة negative_prompt الاختيارية أن تحدد عناصر بصرية ينبغي تجنبها. حافظ على أسماء المعاملات وقيم enum الدقيقة في الطلب.
يبدأ الإنشاء عملية غير متزامنة. احفظ المعرّف الفعلي الذي تعيده استجابة الإنشاء، ثم استخدم GET /v1/videos/{request_id} لمتابعة تلك العملية الأصلية. تمثّل الاستجابة التي تعرض عملًا جاريًا المهمة الموجودة؛ واصل قراءتها حتى تُعاد نتيجة مكتملة أو حالة إخفاق. احتفظ بالخطأ المُعاد والمعرّف الأصلي عندما تفشل العملية أو تحتاج إلى فحص.
عندما تكتمل العملية، احتفظ بكل نتيجة فيديو مُعادة واجلب كل عنوان URL فعلي للمحتوى توفّره الاستجابة. يمكن لمسار المحتوى العام GET /v1/videos/{request_id}/content استرجاع مخرج بفهرسه الفعلي. احفظ الفيديو المكتمل وبياناته الوصفية المُعادة، ثم افحص الموضوع والحركة والتأطير ونهاية المقطع وفق prompt. إذا انتهى الإرسال أو التسليم بصورة ملتبسة، فاحتفظ بهوية العملية الأصلية وافحص تلك المهمة قبل إنشاء توليد آخر.
Ailoot Ultra · Video POST /v1/videos vidu-1.5
vidu-1.5البداية
ينشئ Vidu 1.5 الفيديو من prompt نصي بالمعرّف الدقيق vidu-1.5. صِف الموضوع والفعل المرئي وتأطير الكاميرا، ثم اختر مدة خمس ثوانٍ وإحدى ثلاث نسب أبعاد: 16:9 أو 1:1 أو 9:16. أرسل المهمة مرة واحدة وتابع العملية المُعادة حتى تصبح نتيجة الفيديو جاهزة.
- المدخلات المقبولة
- النص
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Video POST /v1/videos
- الإدخال
text- الإخراج
video
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود vidu-1.5 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 16:9, 1:1, 9:16 | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود 5 | القيمة الافتراضية— |
الحقلnegative_prompt | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt |
المعلمةoptional | المواصفاتaspect_ratio, duration, negative_prompt |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفات |
الأسماء البديلة للطريقة: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتEstimated generation cost | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | الرسوم الإدخال · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.4 تقدير قبل الإنشاء This estimate is not an additional charge or a fixed rate for the completed generation. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "vidu-1.5", "prompt": "A cat is walking on grass."}')
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
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
Retain the complete response, all actual results, original identifiers, usage and response headers.
عند الحاجة إلى التحقق من الاستجابة الأصلية
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلvideo_url | النوعstring or array, as returned |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra vidu-1.5
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · Vidu 1.5
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·vidu-1.5:text→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·vidu-1.5:model,prompt,aspect_ratio,duration,negative_prompt