Skip to main content
GET
الحصول على حالة الفيديو
يتطلب الوصول إلى الميزات التجريبية في مساحة العمل. راجع مهام الفيديو والمعالجة على دفعات لمعرفة الإعداد والويب هوك والتعامل مع النتائج.

التفويضات

Authorization
string
header
مطلوب

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

معلمات المسار

video_id
string
مطلوب

معرّف طلب إنشاء الفيديو.

الاستجابة

200 - 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
آخر تعديل في ٢ أكتوبر ٢٠٢٦