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>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}
Verwenden Sie diesen Endpunkt, wenn 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.

​
Diese Felder zuerst prüfen

  • Wrapper-code und message für Fehler auf oberster Ebene
  • data.status für den CometAPI-Task-Status
  • data.data.status für den verschachtelten Provider-Status
  • data.data.video.url, wenn das Rendering abgeschlossen ist

​
Polling-Schleife

1

Erstellen oder bearbeiten Sie das Video zuerst

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

Fahren Sie mit dem Polling fort, bis der verschachtelte Status abgeschlossen ist

Prüfen Sie sowohl die Wrapper- als auch die verschachtelten Provider-Felder, damit Sie Wrapper-Fehler von Fehlern auf Provider-Ebene unterscheiden können.
3

Speichern Sie die fertige Datei

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

​
Was Sie bei CometAPI erwarten können

Dies ist weiterhin derselbe Polling-Schritt, den xAI in seinem offiziellen Workflow beschreibt. CometAPI fügt eine Wrapper-Hülle um die Provider-Payload hinzu, damit Sie asynchrone Jobs providerübergreifend konsistenter verarbeiten können.

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 task state.

​
code
string
erforderlich
​
message
string
erforderlich
​
data
object
erforderlich