الانتقال إلى المحتوى الرئيسي
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>'
{
  "request_id": "f5f35814-953e-b094-5a2c-4a90014a58cb"
}

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.

استخدم نقطة النهاية هذه بعد أن يكون لديك بالفعل request_id. فهي توضح لك ما إذا كانت مهمة xAI لا تزال قيد التشغيل وتعيد البيانات الوصفية النهائية للفيديو عندما تصبح جاهزة.

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

  • request_id عندما تكون المهمة قد قُبلت ولكن النتيجة ليست جاهزة بعد
  • status لحالة مهمة xAI؛ استمر في الاستعلام الدوري حتى تصل إلى done
  • progress لنسبة الاكتمال المئوية عند إرجاعها
  • video.url عند اكتمال التصيير

​
حلقة الاستعلام الدوري

1

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

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

استمر في الاستعلام الدوري حتى تصبح الحالة done

إذا كانت الاستجابة تكرر فقط request_id، فانتظر بضع ثوانٍ ثم استعلم مرة أخرى. بمجرد ظهور status، استخدمه كشرط للإيقاف.
3

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

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

التفويضات

​
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 xAI video task state.

​
request_id
string

Returned when the request is accepted but result metadata is not ready yet.

​
model
string

xAI video model id.

​
usage
object
​
video
object

Generated video metadata. Present when the job has completed.

​
status
enum<string>

xAI job state. done means the video metadata is ready.

الخيارات المتاحة:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.