Integrationsleitfäden
Fehler
Preise & Abrechnung
xAI
Videogenerierung
Verwenden Sie CometAPI POST /grok/v1/videos/generations, um mit Grok Videos zu erstellen, ein Eingabebild per Prompt zu animieren und Ergebnisse über request_id abzufragen.
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'
{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}Verwenden Sie diesen Endpunkt, um einen Grok-Videojob aus Text oder aus Text plus einem Quellbild zu starten. Er gibt sofort eine
request_id zurück, behandeln Sie ihn also als ersten Schritt in einem asynchronen Workflow.
Mit einer kleinen Anfrage beginnen
- Verwenden Sie
model: grok-imagine-video - Behalten Sie für einen Smoke-Test
durationauf1undresolutionauf480p - Fügen Sie
image.urlnur hinzu, wenn Sie image-to-video verwenden möchten - Wenn Sie base64 senden, behalten Sie die Formularform in der Dokumentation und im OpenAPI-Beispiel als
data:image/png;base64,<BASE64_IMAGE_DATA>bei
Aufgabenablauf
Auf Abschluss prüfen
Rufen Sie Get Video Generation Results auf, bis der verschachtelte provider-Status
done wird.Was sich bei CometAPI ändert
xAI dokumentiert die Videogenerierung als zweistufigen Start -> Poll-Ablauf. CometAPI behält dieselbe Request-Form und dieselbe zentrale model-ID bei, aber Sie authentifizieren sich mit Ihrem CometAPI-Schlüssel und bleiben auf der CometAPI-Basis-URL. Eine echte 1-Sekunden-480p-Anfrage wurde am 2026-03-12 erfolgreich abgeschlossen und gab eine echte Ergebnis-URL zurück.Autorisierungen
Bearer token authentication. Use your CometAPI key.
Body
application/json
Prompt for the video job.
Beispiel:
"A candle flickers on a wooden table."
Output aspect ratio.
Verfügbare Optionen:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
Beispiel:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
Verfügbare Optionen:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
Antwort
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'
{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}