Edit Video

Gunakan POST /grok/v1/videos/edits untuk mengedit video sumber dengan prompt teks, mempertahankan gerakan, dan mendapatkan request_id untuk polling hasil async.

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

Gunakan endpoint ini untuk mengedit MP4 yang sudah ada dengan instruksi teks. Output akan tetap lebih dekat dengan timing dan komposisi klip sumber dibandingkan permintaan generasi baru.

​

Sebelum Anda mengirim permintaan

• Sediakan video.url yang dapat diakses
• Jaga agar klip sumber tetap pendek; panduan xAI sendiri membatasi edit hingga sekitar 8,7 detik
• Gunakan instruksi yang terfokus dan menjelaskan satu perubahan yang jelas
• Simpan request_id yang dikembalikan, karena edit menggunakan alur polling yang sama seperti generasi

​

Alur pengeditan

1. Kirim permintaan edit

   Kirim URL video sumber, prompt edit, dan model: grok-imagine-video.

2. Poll untuk hasil akhir

   Panggil Get Video Generation Results hingga pekerjaan selesai.

3. Simpan aset hasil edit

   Unduh output yang sudah selesai atau pindahkan URL yang dikembalikan ke pipeline penyimpanan Anda sendiri.

​

Apa yang berubah di CometAPI

xAI mendokumentasikan pengeditan video sebagai lifecycle async yang sama seperti generasi, hanya saja menggunakan video sumber alih-alih source image opsional. CometAPI mempertahankan perilaku tersebut dan endpoint polling yang sama, sehingga workflow edit Anda tetap start -> poll -> download.

Otorisasi

Authorization · string · header · wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json

prompt · string · wajib

Edit instruction describing the change you want.

Contoh:

"Add snow to the scene."

video · object · wajib

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

Show child attributes

model · string · default: grok-imagine-video

xAI video model id.

Contoh:

"grok-imagine-video"

output · object

Optional output delivery configuration.

user · string

Optional end-user identifier.

Respons

200 - application/json

Request accepted.

request_id · string · wajib

Deferred request id used for polling.