الانتقال إلى المحتوى الرئيسي
POST
إنشاء فيديو
نقطة النهاية هذه في مرحلة ألفا، وتُفعَّل لكل مساحة عمل عند الطلب. راجع مهام الفيديو والمعالجة على دفعات لمعرفة الإعداد والويب هوك والتعامل مع النتائج.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json
model
string
مطلوب
prompt
string
مطلوب
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
duration
integer

المدة المطلوبة بالثواني (تعتمد على المزوّد/النموذج).

input_video_duration
number<double>

مدة الفيديو المصدر بالثواني. مطلوبة عندما يفوتر المزوّد مدة الفيديو المصدر بشكل مستقل عن الناتج المُنشأ.

النطاق المطلوب: 0 < x <= 3600
input_audio_duration
number<double>

مدة الصوت المصدر المعلنة بالثواني، المستخدمة للتحقق من نطاق المزوّد. قد يفوتر المزوّدون الذين لا يبلغون عن الاستخدام المعتمد وفق الحد الأعلى لمدة الإدخال المدعومة لديهم.

النطاق المطلوب: 2 <= x <= 20
size
string

أبعاد صريحة (مثل 1280x720). لا يمكن دمجها مع resolution أو aspect_ratio.

resolution
string

480p و720p و1080p و1K و2K و4K. يمكن دمجها مع aspect_ratio. لا يمكن دمجها مع size.

aspect_ratio
string

نسبة أبعاد مثل 16:9 أو9:16 أو1:1. يمكن دمجها مع resolution. لا يمكن دمجها مع size.

seed
integer
sample_count
integer
النطاق المطلوب: 1 <= x <= 4
negative_prompt
string
generate_audio
boolean
enhance_prompt
boolean
compression_quality

ضغط المخرجات. يقبل Vertex Veo القيمة optimized أو lossless ويرفض الرقم؛ أما المزوّدون الآخرون الذين يدعمونه فيقبلون عددًا صحيحًا.

person_generation
string
resize_mode
string
input_references
object[]

مدخلات صور أو صوت أو فيديو عبر HTTPS لتوجيه الإنشاء. تعتمد الأنواع والأدوار والأعداد والتركيبات المدعومة على النموذج المحدد. تحقق من GET /videos/models قبل إرسال مهمة. يقبل الاسم البديل المفرد للتوافق input_reference، غير المدرج في هذا المخطط، صورة multipart أو كائناً يتضمن واحداً فقط من file_id أو image_url. يعتمد الدعم على المزوّد.

مدخل وسائط HTTPS محدد النوع. استخدم image_url للصور وmedia_url للصوت أو الفيديو. تصف الأدوار كيفية استخدام النموذج للمدخل؛ ويختلف الدعم حسب المزوّد والنموذج.

frame_images
object[]

صور HTTPS للإطار الأول/الأخير. يمكن أن يظهر كل frame_type مرة واحدة. لا تقدم أيضاً input_reference أو أدوار الإطارات ضمن input_references.

Required array length: 1 - 2 elements
provider_params
object

امتدادات خاصة بالمزوّد فقط. يُرفض تمرير الطلب كاملاً وتكرار حقول التوجيه أو الموجه أو رد الاتصال أو الفوترة. على سبيل المثال، يقبل Wan 3.0 الخيار smart_duration: true ليختار النموذج المدة (لا ترسل duration معه)؛ تحجز المهمة 30 ثانية وتُحتسب المدة التي يبلغ عنها المزوّد.

provider_options
object

امتدادات بمفاتيح معرّفات المزوّدين الأساسية (مثل atlascloud أو byteplus). تُمرر خيارات المزوّد المحدد فقط. لا يمكن دمجها مع provider_params. يجب أن تستخدم حقول التوجيه والموجه ورد الاتصال والمدة والدقة وعدد النواتج حقول المستوى الأعلى التي تم التحقق منها.

output
object
webhook
object
provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

الاستجابة

202 - application/json

استجابة الفيديو

id
string
polling_url
string
websocket_url
string<uri>

عنوان WebSocket للاشتراك في تحديثات دورة الحياة الموحدة للمهام غير المتزامنة.

model
string
request_id
string
session_id
string
status
enum<string>
الخيارات المتاحة:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

حالة دورة الحياة غير المتزامنة الموحدة لمستهلكي الاستطلاع وWebSocket وwebhook.

الخيارات المتاحة:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

محجوز للتوافق؛ قيمته حالياً null دائماً.

output_access
enum<string>
الخيارات المتاحة:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

معرّف الفيديو/المهمة الأصلي لدى المزوّد عندما يختلف عن معرّف البوابة.

created_at
started_at
completed_at
object
string
مثال:

"video"

poll_after_seconds
integer
مثال:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

موجود عندما يتضمن output_access القيمة bytes (نقطة نهاية تتطلب المصادقة).

download_url
string | null

عنوان URL موقّع من الطرف الأول للتنزيل المباشر عندما تكون الحالة completed.

expires_at
integer | null

طابع Unix الزمني (بالثواني) لانتهاء صلاحية download_url الموقّع.

progress
integer | null
progress_source
string
asset
object | null
outputs
object[]
billing
object
webhook
object

إعداد webhook غير المتزامن بعد تنقيح البيانات الحساسة مع حالة التسليم. لا تُرجع الأسرار أبداً؛ يشير has_secret إلى تفعيل عمليات التسليم الموقّعة. تتضمن عمليات التسليم الموقّعة ترويسات x-phaseo-signature وx-phaseo-timestamp وx-phaseo-event-id وx-phaseo-event-type وx-phaseo-delivery-key وx-phaseo-attempt وx-phaseo-max-attempts.

next_webhook_retry_at
string | null

طابع ISO الزمني لإعادة محاولة webhook المستخدم المجدولة التالية، إن كانت في قائمة الانتظار.

last_webhook_progress
number | null

أحدث فئة تقدم تقريبية أُرسلت إلى مستهلكي webhook.

last_webhook_progress_at
string | null

طابع ISO الزمني عند إرسال أحدث فئة تقدم لـwebhook.

last_webhook_dispatched_at
string | null

طابع ISO الزمني لأحدث محاولة إرسال webhook.

usage
object
error
unknown
آخر تعديل في ١٦ نوفمبر ٢٠٢٦