Zum Hauptinhalt springen
GET
/
grok
/
v1
/
videos
/
{request_id}
Query an xAI video job
curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "request_id": "f5f35814-953e-b094-5a2c-4a90014a58cb"
}

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.

Verwenden Sie diesen Endpoint, nachdem Sie bereits eine request_id haben. Er zeigt Ihnen, ob der xAI-Job noch läuft, und gibt die endgültigen Video-Metadaten zurück, sobald sie bereit sind.

​
Prüfen Sie zuerst diese Felder

  • request_id, wenn die Aufgabe angenommen wurde, das Ergebnis aber noch nicht bereit ist
  • status für den Status des xAI-Jobs; fragen Sie weiter ab, bis done erreicht ist
  • progress für den Prozentsatz des Fortschritts, wenn er zurückgegeben wird
  • video.url, wenn das Rendering abgeschlossen ist

​
Polling-Schleife

1

Erstellen oder bearbeiten Sie zuerst das Video

Beginnen Sie mit Video Generation oder Video Edit und kopieren Sie dann die zurückgegebene request_id.
2

Fragen Sie weiter ab, bis status done ist

Wenn die Antwort nur request_id zurückgibt, warten Sie einige Sekunden und fragen Sie erneut ab. Sobald status erscheint, verwenden Sie es als Abbruchbedingung.
3

Speichern Sie die fertige Datei

Laden Sie die endgültige video.url sofort herunter oder kopieren Sie sie, da xAI generierte URLs als temporär dokumentiert.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Pfadparameter

​
request_id
string
erforderlich

Deferred request id returned by the create or edit endpoint.

Antwort

200 - application/json

Current xAI video task state.

​
request_id
string

Returned when the request is accepted but result metadata is not ready yet.

​
model
string

xAI video model id.

​
usage
object
​
video
object

Generated video metadata. Present when the job has completed.

​
status
enum<string>

xAI job state. done means the video metadata is ready.

Verfügbare Optionen:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.