الانتقال إلى المحتوى الرئيسي
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"
}

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.

استخدم نقطة النهاية هذه لبدء مهمة فيديو في Grok من نص، أو من نص بالإضافة إلى صورة مصدر واحدة. وهي تعيد request_id فورًا، لذا تعامل معها باعتبارها الخطوة الأولى في سير عمل غير متزامن.

​
ابدأ بطلب صغير

  • استخدم model: grok-imagine-video
  • في أول طلب، أبقِ duration على 1 وresolution على 480p
  • أضف image.url فقط عندما تريد تحويل صورة إلى فيديو
  • إذا أرسلت base64، فأبقِ صيغة التوثيق ومثال OpenAPI كما هي: data:image/png;base64,<BASE64_IMAGE_DATA>

​
تدفق المهمة

1

إنشاء المهمة

أرسل Prompt واحفظ request_id المُعاد.
2

الاستعلام حتى الاكتمال

استدعِ Get Video Generation Results حتى تصبح حالة المزوّد المتداخلة done.
3

الاحتفاظ بالمخرجات

انسخ video.url النهائي إلى مساحة التخزين الخاصة بك إذا كنت بحاجة إليه بعد نافذة التسليم المؤقتة الخاصة بالمزوّد.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
​
prompt
string
مطلوب

Prompt for the video job.

مثال:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

الخيارات المتاحة:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
افتراضي:1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

​
image
object

Optional source image for image-to-video.

​
model
string
افتراضي:grok-imagine-video

xAI video model id.

مثال:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

الخيارات المتاحة:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

الاستجابة

200 - application/json

Request accepted.

​
request_id
string
مطلوب

Deferred request id used for polling.