الانتقال إلى المحتوى الرئيسي
POST
/
grok
/
v1
/
videos
/
edits
Create an xAI video edit job
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"
  }
}
'
{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

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.

استخدم نقطة النهاية هذه لتحرير ملف 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.

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