أدلة التكامل
الأخطاء
الأسعار والفوترة
واجهة API الرسمية
استرجاع الفيديو
استخدم CometAPI GET /v1/videos/ لاسترجاع حالة فيديو Sora 2، والتقدم، والبيانات الوصفية مثل المدة والأبعاد والطوابع الزمنية ووقت الانتهاء.
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
}استخدم نقطة النهاية هذه بعد بدء مهمة Sora. فهي تعرض الحالة الحالية للمهمة، والحجم والمدة المكوّنين، وأي خطأ يعيده المزوّد.
راقب هذه الحقول
statusلمعرفة حالة دورة الحياةprogressللحصول على إشارة تقريبية عن التقدمerrorعندما يرفض المزوّد المهمة أو تفشلexpires_atبعد الاكتمال إذا كنت بحاجة إلى معرفة وقت انتهاء صلاحية الأصول المؤقتة
نفّذ Poll حتى الاكتمال
أنشئ الفيديو أو أعد مزجه أولاً
ابدأ باستخدام Create Video أو Remix Video.
نفّذ Poll باستخدام المعرّف
مرّر
id المُعاد هنا واستمر في التحقق حتى تصل المهمة إلى completed أو failed.نزّل الملف
عندما تصبح المهمة
completed، انتقل إلى Retrieve Video Content.شكل الاستجابة في CometAPI
تتطابق هذه الخطوة بشكل وثيق مع سير عمل Polling في Sora. يحتفظ CometAPI بشكل الكائن بأسلوب OpenAI حتى تتمكن من ربط فحوصات الحالة بأقل قدر من التعديل.التفويضات
Bearer token authentication. Use your CometAPI key.
معلمات المسار
Video id returned by the create or remix endpoint.
الاستجابة
200 - application/json
Current job state.
⌘I
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
}