الانتقال إلى المحتوى الرئيسي
GET
/
grok
/
v1
/
videos
/
{request_id}
Query an xAI video job
curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}
استخدم نقطة النهاية هذه بعد أن يكون لديك بالفعل request_id. فهي تخبرك ما إذا كانت مهمة xAI لا تزال قيد التشغيل وتُرجع البيانات الوصفية النهائية للفيديو عندما يصبح جاهزًا.

​
تحقّق من هذه الحقول أولاً

  • code وmessage في الغلاف لأخطاء المستوى الأعلى
  • data.status لحالة مهمة CometAPI
  • data.data.status لحالة المزوّد المتداخلة
  • data.data.video.url عند اكتمال التصيير

​
حلقة الاستعلام المتكرر

1

أنشئ الفيديو أو حرّره أولاً

ابدأ من Video Generation أو Video Edit، ثم انسخ request_id الذي تم إرجاعه.
2

واصل الاستعلام المتكرر حتى تصبح الحالة المتداخلة done

تحقّق من حقول الغلاف وحقول المزوّد المتداخلة معًا حتى تتمكن من التمييز بين إخفاقات الغلاف والإخفاقات على مستوى المزوّد.
3

احفظ الملف المكتمل

نزّل video.url النهائي أو انسخه بسرعة، لأن xAI توثّق أن الروابط المُنشأة مؤقتة.

​
ما الذي يمكن توقّعه على CometAPI

لا تزال هذه هي خطوة الاستعلام نفسها التي تصفها xAI في سير العمل الرسمي الخاص بها. تضيف CometAPI غلافًا حول حمولة المزوّد حتى تتمكن من التعامل مع المهام غير المتزامنة بشكل أكثر اتساقًا عبر مختلف المزوّدين.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

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

​
request_id
string
مطلوب

Deferred request id returned by the create or edit endpoint.

الاستجابة

200 - application/json

Current task state.

​
code
string
مطلوب
​
message
string
مطلوب
​
data
object
مطلوب