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 job xAI masih berjalan dan mengembalikan metadata video final saat sudah siap.

​
Periksa field ini terlebih dahulu

  • Wrapper code dan message untuk error tingkat atas
  • data.status untuk status task CometAPI
  • data.data.status untuk status provider bersarang
  • 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

Lanjutkan polling sampai status bersarang selesai

Periksa field wrapper dan provider bersarang agar Anda bisa membedakan kegagalan wrapper dari kegagalan di tingkat provider.
3

Simpan file yang sudah selesai

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

​
Yang perlu diharapkan di CometAPI

Ini masih merupakan langkah polling yang sama seperti yang dijelaskan xAI dalam alur kerja resminya. CometAPI menambahkan wrapper envelope di sekitar payload provider sehingga Anda dapat menangani job async dengan lebih konsisten di berbagai provider.

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