Ana içeriğe atla
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.

Bu endpoint’i, zaten bir request_id değerine sahip olduktan sonra kullanın. xAI işinin hâlâ çalışıp çalışmadığını bildirir ve hazır olduğunda nihai video metadata’sını döndürür.

​
Önce bu alanları kontrol edin

  • görev kabul edildiğinde ancak sonuç henüz hazır olmadığında request_id
  • xAI iş durumu için status; done değerine ulaşana kadar sorgulamaya devam edin
  • döndürüldüğünde tamamlanma yüzdesi için progress
  • render tamamlandığında video.url

​
Sorgulama döngüsü

1

Önce videoyu oluşturun veya düzenleyin

Video Generation veya Video Edit ile başlayın, ardından döndürülen request_id değerini kopyalayın.
2

status done olana kadar sorgulamaya devam edin

Yanıt yalnızca request_id değerini geri döndürüyorsa birkaç saniye bekleyin ve tekrar sorgulayın. status göründüğünde, bunu durdurma koşulu olarak kullanın.
3

Tamamlanan dosyayı kaydedin

Nihai video.url değerini hemen indirin veya kopyalayın, çünkü xAI oluşturulan URL’leri geçici olarak belgelendirir.

Yetkilendirmeler

​
Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Yol Parametreleri

​
request_id
string
gerekli

Deferred request id returned by the create or edit endpoint.

Yanıt

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.

Mevcut seçenekler:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.