Zum Hauptinhalt springen
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"
}
Verwenden Sie diesen Endpoint, um ein vorhandenes MP4 mit einer Textanweisung zu bearbeiten. Die Ausgabe bleibt näher am Timing und an der Komposition des Quellclips als bei einer neuen Generierungsanfrage.

​
Bevor Sie die Anfrage senden

  • Stellen Sie eine erreichbare video.url bereit
  • Halten Sie den Quellclip kurz; die eigene Empfehlung von xAI begrenzt Bearbeitungen auf etwa 8,7 Sekunden
  • Verwenden Sie eine präzise Anweisung, die eine klare Änderung beschreibt
  • Speichern Sie die zurückgegebene request_id, da Bearbeitungen denselben Polling-Ablauf wie die Generierung verwenden

​
Bearbeitungsablauf

1

Bearbeitungsanfrage senden

Senden Sie die URL des Quellvideos, den Bearbeitungs-Prompt und model: grok-imagine-video.
2

Auf das endgültige Ergebnis pollen

Rufen Sie Get Video Generation Results auf, bis der Job abgeschlossen ist.
3

Das bearbeitete Asset speichern

Laden Sie die fertige Ausgabe herunter oder übernehmen Sie die zurückgegebene URL in Ihre eigene Storage-Pipeline.

​
Was sich bei CometAPI ändert

xAI dokumentiert die Videobearbeitung als denselben asynchronen Lebenszyklus wie die Generierung, nur mit einem Quellvideo anstelle eines optionalen Quellbilds. CometAPI behält dieses Verhalten und denselben Polling-Endpoint bei, sodass Ihr Bearbeitungs-Workflow weiterhin start -> poll -> download ist.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
prompt
string
erforderlich

Edit instruction describing the change you want.

Beispiel:

"Add snow to the scene."

​
video
object
erforderlich

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

​
model
string
Standard:grok-imagine-video

xAI video model id.

Beispiel:

"grok-imagine-video"

​
output
object

Optional output delivery configuration.

​
user
string

Optional end-user identifier.

Antwort

200 - application/json

Request accepted.

​
request_id
string
erforderlich

Deferred request id used for polling.