تحرير الفيديو

استخدم POST /grok/v1/videos/edits لتحرير فيديو مصدر باستخدام Prompt نصي، مع الحفاظ على الحركة، والحصول على request_id لنتائج الاستعلام غير المتزامن.

POST /grok/v1/videos/edits

Create an xAI video edit job

cURL

curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Add snow to the scene.",
  "video": {
    "url": "https://example.com/source.mp4"
  }
}
'

200

{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

استخدم نقطة النهاية هذه لتحرير ملف MP4 موجود باستخدام تعليمات نصية. يظل الناتج أقرب إلى توقيت المقطع المصدر وتكوينه مقارنةً بطلب إنشاء جديد من الصفر.

​

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

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

​

سير عمل التحرير

1. إرسال طلب التحرير

   أرسل رابط فيديو المصدر، وPrompt التحرير، وmodel: grok-imagine-video.

2. الاستعلام عن النتيجة النهائية

   استدعِ Get Video Generation Results حتى تنتهي المهمة.

3. تخزين الأصل المُحرَّر

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

​

ما الذي يتغير في 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.

Show child attributes

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.