Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لتعديل ملف MP4 موجود باستخدام تعليمات نصية. يبقى الناتج أقرب إلى توقيت وتركيب المقطع المصدر مقارنةً بطلب إنشاء جديد من الصفر.

قبل إرسال الطلب

  • قدّم video.url يمكن الوصول إليه
  • اجعل المقطع المصدر قصيرًا؛ فإرشادات xAI نفسها تحدد الحد الأقصى للتعديلات بحوالي 8.7 ثانية
  • استخدم تعليمات مركزة تصف تغييرًا واضحًا واحدًا
  • احفظ قيمة request_id المعادة، لأن التعديلات تستخدم نفس آلية الاستطلاع المستخدمة في الإنشاء

تدفق التعديل

1

إرسال طلب التعديل

أرسل URL الفيديو المصدر، وPrompt التعديل، وmodel: grok-imagine-video.
2

استطلاع النتيجة النهائية

استدعِ الحصول على نتائج فيديو xAI حتى تنتهي المهمة.
3

تخزين الأصل المعدّل

نزّل الناتج النهائي أو انقل URL المعاد إلى مسار التخزين الخاص بك.

ما الذي يتغير على CometAPI

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
prompt
string
مطلوب

Edit instruction describing the change you want.

مثال:

"Add snow to the scene."

video
object
مطلوب

Source video to edit. xAI documents an input limit of about 8.7 seconds.

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

xAI video model id.

مثال:

"grok-imagine-video"

output
object

Optional output delivery configuration.

user
string

Optional end-user identifier.

الاستجابة

200 - application/json

Request accepted.

request_id
string
مطلوب

Deferred request id used for polling.