Ana içeriğe atla
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.

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.

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