Video Düzenleme

Bir kaynak videoyu metin Prompt’u ile düzenlemek, hareketi korumak ve async polling sonuçları için bir request_id almak üzere POST /grok/v1/videos/edits kullanın.

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"
}

Mevcut bir MP4’ü metin talimatıyla düzenlemek için bu endpoint’i kullanın. Çıktı, yeni bir üretim isteğine kıyasla kaynak klibin zamanlamasına ve kompozisyonuna daha yakın kalır.

​

İsteği göndermeden önce

• Erişilebilir bir video.url sağlayın
• Kaynak klibi kısa tutun; xAI’ın kendi yönergeleri düzenlemeleri yaklaşık 8,7 saniye ile sınırlar
• Tek ve net bir değişikliği açıklayan odaklı bir talimat kullanın
• Dönen request_id değerini kaydedin, çünkü düzenlemeler üretimle aynı polling akışını kullanır

​

Düzenleme akışı

1. Düzenleme isteğini gönderin

   Kaynak video URL’sini, düzenleme Prompt’unu ve model: grok-imagine-video gönderin.

2. Nihai sonuç için polling yapın

   İş tamamlanana kadar Get Video Generation Results çağrısını yapın.

3. Düzenlenmiş varlığı depolayın

   Tamamlanan çıktıyı indirin veya dönen URL’yi kendi depolama hattınıza taşıyın.

​

CometAPI’de neler değişiyor

xAI, video düzenlemeyi üretimle aynı async yaşam döngüsü olarak belgeler; tek fark, isteğe bağlı bir kaynak görsel yerine kaynak video kullanılmasıdır. CometAPI bu davranışı ve aynı polling endpoint’ini korur, bu nedenle düzenleme iş akışınız yine başlat -> poll -> indir şeklinde devam eder.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

prompt · string · gerekli

Edit instruction describing the change you want.

Örnek:

"Add snow to the scene."

video · object · gerekli

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

Show child attributes

model · string · varsayılan: grok-imagine-video

xAI video model id.

Örnek:

"grok-imagine-video"

output · object

Optional output delivery configuration.

user · string

Optional end-user identifier.

Yanıt

200 - application/json

Request accepted.

request_id · string · gerekli

Deferred request id used for polling.