Naar hoofdinhoud gaan
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"
}
Gebruik deze endpoint om een bestaande MP4 te bewerken met een tekstinstructie. De output blijft dichter bij de timing en compositie van de bronclip dan bij een volledig nieuwe generation-aanvraag.

Voordat je de aanvraag verstuurt

  • Zorg voor een bereikbaar video.url
  • Houd de bronclip kort; volgens de eigen richtlijnen van xAI zijn bewerkingen beperkt tot ongeveer 8,7 seconden
  • Gebruik een gerichte instructie die één duidelijke wijziging beschrijft
  • Bewaar de geretourneerde request_id, omdat bewerkingen dezelfde pollingflow gebruiken als generation

Bewerkingsflow

1

Dien de bewerkingsaanvraag in

Stuur de URL van de bronvideo, de bewerkingsprompt en model: grok-imagine-video.
2

Poll voor het definitieve resultaat

Roep Get Video Generation Results aan totdat de taak is voltooid.
3

Sla het bewerkte bestand op

Download de voltooide output of verplaats de geretourneerde URL naar je eigen storage-pipeline.

Wat verandert er op CometAPI

xAI documenteert videobewerking als dezelfde asynchrone levenscyclus als generation, alleen met een bronvideo in plaats van een optionele bronafbeelding. CometAPI behoudt dat gedrag en dezelfde polling-endpoint, dus je bewerkingsworkflow blijft start -> poll -> download.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json
prompt
string
vereist

Edit instruction describing the change you want.

Voorbeeld:

"Add snow to the scene."

video
object
vereist

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

model
string
standaard:grok-imagine-video

xAI video model id.

Voorbeeld:

"grok-imagine-video"

output
object

Optional output delivery configuration.

user
string

Optional end-user identifier.

Respons

200 - application/json

Request accepted.

request_id
string
vereist

Deferred request id used for polling.