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>'
{
  "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.

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

  • request_id saat tugas telah diterima tetapi hasilnya belum siap
  • status untuk status job xAI; terus lakukan polling hingga mencapai done
  • progress untuk persentase penyelesaian saat dikembalikan
  • 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 hingga status done

Jika respons hanya mengembalikan request_id, tunggu beberapa detik lalu lakukan polling lagi. Setelah status muncul, gunakan itu sebagai kondisi berhenti.
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 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.

Opsi yang tersedia:
queued,
processing,
done,
failed,
expired
progress
integer

Completion percentage when returned.

error

Error details when the job fails.