Skip to main content
GET
استخدم نقطة النهاية هذه بعد أن يكون لديك request_id بالفعل. فهي تخبرك ما إذا كانت مهمة xAI لا تزال قيد التشغيل وتُرجع البيانات الوصفية النهائية للفيديو عندما تصبح جاهزة.

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

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

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

1

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

ابدأ من إنشاء فيديو xAI أو إنشاء تعديل على فيديو xAI، ثم انسخ request_id الذي تم إرجاعه.
2

واصل الاستعلام حتى تصبح status هي 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

Billing metadata. cost_in_usd_ticks reports the cost in provider ticks.

​
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.