الانتقال إلى المحتوى الرئيسي
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "size": "1280x720",
  "error": null,
  "model": "sora-2",
  "object": "video",
  "prompt": "A paper airplane glides across a desk.",
  "status": "in_progress",
  "seconds": "4",
  "progress": 0,
  "created_at": 1773296991,
  "expires_at": null,
  "completed_at": null,
  "remixed_from_video_id": null
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

استخدم نقطة النهاية هذه بعد بدء مهمة Sora. فهي تعرض الحالة الحالية للمهمة، والحجم والمدة المكوّنين، وأي خطأ يعيده المزوّد.

​
راقب هذه الحقول

  • status لمعرفة حالة دورة الحياة
  • progress للحصول على إشارة تقريبية عن التقدم
  • error عندما يرفض المزوّد المهمة أو تفشل
  • expires_at بعد الاكتمال إذا كنت بحاجة إلى معرفة وقت انتهاء صلاحية الأصول المؤقتة

​
نفّذ Poll حتى الاكتمال

1

أنشئ الفيديو أو أعد مزجه أولاً

ابدأ باستخدام Create Video أو Remix Video.
2

نفّذ Poll باستخدام المعرّف

مرّر id المُعاد هنا واستمر في التحقق حتى تصل المهمة إلى completed أو failed.
3

نزّل الملف

عندما تصبح المهمة completed، انتقل إلى Retrieve Video Content.

​
شكل الاستجابة في CometAPI

تتطابق هذه الخطوة بشكل وثيق مع سير عمل Polling في Sora. يحتفظ CometAPI بشكل الكائن بأسلوب OpenAI حتى تتمكن من ربط فحوصات الحالة بأقل قدر من التعديل.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

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

​
video_id
string
مطلوب

Video id returned by the create or remix endpoint.

الاستجابة

200 - application/json

Current job state.

​
id
string
مطلوب
​
size
string
مطلوب
​
model
string
مطلوب
​
object
string
مطلوب
​
status
string
مطلوب
​
seconds
string
مطلوب
​
progress
integer
مطلوب
​
created_at
integer
مطلوب
​
error
object
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null
​
remixed_from_video_id
string | null