Naar hoofdinhoud gaan
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.

Gebruik dit endpoint nadat je al een request_id hebt. Het laat zien of de xAI-taak nog steeds wordt uitgevoerd en retourneert de definitieve videometadata zodra die klaar is.

​
Controleer eerst deze velden

  • request_id wanneer de taak is geaccepteerd maar het resultaat nog niet klaar is
  • status voor de status van de xAI-taak; blijf pollen totdat deze done bereikt
  • progress voor het voltooiingspercentage wanneer dit wordt geretourneerd
  • video.url wanneer de render voltooid is

​
Polling-lus

1

Maak of bewerk eerst de video

Begin met Video Generation of Video Edit, en kopieer vervolgens de geretourneerde request_id.
2

Blijf pollen totdat status done is

Als de response alleen request_id teruggeeft, wacht dan een paar seconden en poll opnieuw. Zodra status verschijnt, gebruik je dat als stopvoorwaarde.
3

Sla het voltooide bestand op

Download of kopieer de definitieve video.url snel, omdat xAI gegenereerde URL’s als tijdelijk documenteert.

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Padparameters

​
request_id
string
vereist

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.

Beschikbare opties:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.