أدلة التكامل
الأخطاء
الأسعار والفوترة
xAI
إنشاء الفيديو
استخدم CometAPI POST /grok/v1/videos/generations لإنشاء مقاطع فيديو باستخدام Grok، وتحريك صورة إدخال عبر Prompt، والاستعلام عن النتائج باستخدام request_id.
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}استخدم نقطة النهاية هذه لبدء مهمة فيديو في Grok من نص، أو من نص مع صورة مصدر واحدة. تُرجع
request_id فورًا، لذا تعامل معها كخطوة أولى في سير عمل غير متزامن.
ابدأ بطلب صغير
- استخدم
model: grok-imagine-video - لاختبار سريع، أبقِ
durationعند1وresolutionعند480p - أضف
image.urlفقط عندما تريد تحويل صورة إلى فيديو - إذا أرسلت base64، فأبقِ صيغة المستندات ومثال OpenAPI كما هي:
data:image/png;base64,<BASE64_IMAGE_DATA>
تدفق المهمة
الاستعلام حتى الاكتمال
استدعِ Get Video Generation Results إلى أن تصبح حالة المزوّد المتداخلة
done.ما الذي يتغير على CometAPI
توثّق xAI إنشاء الفيديو كتدفق من خطوتين: بدء -> استعلام. يحتفظ CometAPI بنفس شكل الطلب ونفس معرّف النموذج الأساسي، لكنك تقوم بالمصادقة باستخدام مفتاح CometAPI الخاص بك وتبقى على عنوان URL الأساسي لـ CometAPI. اكتمل طلب فعلي مباشر لمدة ثانية واحدة وبدقة 480p بنجاح في 2026-03-12 وأعاد عنوان URL حقيقيًا للنتيجة.التفويضات
Bearer token authentication. Use your CometAPI key.
الجسم
application/json
Prompt for the video job.
مثال:
"A candle flickers on a wooden table."
Output aspect ratio.
الخيارات المتاحة:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
مثال:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
الخيارات المتاحة:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
الاستجابة
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}