Langsung ke konten utama
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"
    }
  }
}
Gunakan endpoint ini setelah Anda sudah memiliki request_id. Endpoint ini memberi tahu apakah pekerjaan xAI masih berjalan dan mengembalikan metadata video final saat sudah siap.

Periksa field ini terlebih dahulu

  • code dan message untuk error tingkat atas
  • data.status untuk status task CometAPI
  • data.data.status untuk status provider bertingkat
  • data.data.video.url saat render selesai

Loop polling

1

Buat atau edit video terlebih dahulu

Mulai dengan Video Generation atau Video Edit, lalu salin request_id yang dikembalikan.
2

Terus lakukan polling sampai status bertingkat bernilai done

Periksa field tingkat atas dan provider bertingkat agar Anda dapat membedakan kegagalan tingkat atas dari kegagalan tingkat provider.
3

Simpan file yang sudah selesai

Unduh atau salin video.url final sesegera mungkin, karena xAI mendokumentasikan URL yang dihasilkan sebagai sementara.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Parameter Path

request_id
string
wajib

Deferred request id returned by the create or edit endpoint.

Respons

200 - application/json

Current task state.

code
string
wajib
message
string
wajib
data
object
wajib