Hopp til hovedinnhold
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.

Bruk dette endepunktet til å redigere en eksisterende MP4 med en tekstinstruksjon. Utdataene holder seg nærmere kildeklippets timing og komposisjon enn en ny genereringsforespørsel.

​
Før du sender forespørselen

  • Oppgi en tilgjengelig video.url
  • Hold kildeklippet kort; xAIs egen veiledning begrenser redigeringer til omtrent 8,7 sekunder
  • Bruk en presis instruksjon som beskriver én tydelig endring
  • Lagre den returnerte request_id, fordi redigeringer bruker samme pollingflyt som generering

​
Redigeringsflyt

1

Send inn redigeringsforespørselen

Send URL-en til kildevideoen, redigeringsprompten og model: grok-imagine-video.
2

Poll for det endelige resultatet

Kall Get Video Generation Results til jobben er fullført.
3

Lagre den redigerte ressursen

Last ned det ferdige resultatet eller flytt den returnerte URL-en inn i din egen lagringspipeline.

​
Hva som endres på CometAPI

xAI dokumenterer videoredigering som samme asynkrone livssyklus som generering, bare med en kildevideo i stedet for et valgfritt kildebilde. CometAPI beholder denne oppførselen og det samme pollingendepunktet, så redigeringsarbeidsflyten din er fortsatt start -> poll -> last ned.

Autorisasjoner

​
Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

application/json
​
prompt
string
påkrevd

Edit instruction describing the change you want.

Eksempel:

"Add snow to the scene."

​
video
object
påkrevd

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

​
model
string
standard:grok-imagine-video

xAI video model id.

Eksempel:

"grok-imagine-video"

​
output
object

Optional output delivery configuration.

​
user
string

Optional end-user identifier.

Svar

200 - application/json

Request accepted.

​
request_id
string
påkrevd

Deferred request id used for polling.