Video Generation Status

Check the status of a video generation job created by POST /api/v1/video. Poll this endpoint until status is completed or failed. Recommended polling interval: every 10–30 seconds. No additional charge for polling. Works with all video models.

GET /api/v1/video/status

Video Generation Status

cURL

curl --request GET \
  --url https://ninjachat.ai/api/v1/video/status \
  --header 'Authorization: Bearer <token>'

200

processing

{
  "request_id": "gemini-veo:operations/generate-video-abc123",
  "status": "processing",
  "progress": 45
}

Authorizations

Authorization · string · header · required

API key starting with nj_sk_

Query Parameters

request_id · string · required

The request_id returned from POST /api/v1/video.

Response

200

application/json

Job status.

request_id · string

The original request ID.

status · enum<string>

processing — still generating (check progress). completed — video is ready (see result.video_url). failed — generation failed (see error).

Available options: processing, completed, failed

progress · integer

Approximate progress percentage (0–95). Only present when status is processing.

Required range: 0 <= x <= 95

result · object

Show child attributes

error · string

Error description. Only present when status is failed.