Token360
Sign Up

Poll video generation status

GET/v1/videos/{video_id}

Poll a video generation task created by POST /v1/videos. Use the submitted task id to check whether generation is still queued, running, completed, or failed.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Path Parameters

video_idstringrequired

The video task ID.

Response

idstring

Video task ID.

objectstring

Always video.

statusenum<string>

queued, in_progress, completed, or failed.

modelstring

Model used.

promptstring

Input prompt.

created_atinteger

Unix timestamp.

updated_atinteger

Last-updated Unix timestamp.

parametersobject

Echo of generation parameters such as resolution, duration, aspect_ratio, seed, audio, and watermark.

responseobject

Raw response details when available.

urlstring

Presigned video URL when status=completed.

video_urlstring

Video URL when available.

durationinteger

Final video duration in seconds when completed.

contentobject

Additional generated assets when returned.

content.last_frame_urlstring

Last-frame image URL when return_last_frame=true and returned.

errorobject

Error details when status=failed.

error.codestring

Error code.

error.messagestring

Human-readable error message.

usageobject

Usage and billing details when available.

usage.prompt_tokensinteger

Input token count when returned.

usage.completion_tokensinteger

Output token count when returned.

usage.total_tokensinteger

Total token count when returned.

usage.input_tokensinteger

Input token count for providers that use input/output names.

usage.output_tokensinteger

Output token count for providers that use input/output names.

usage.generated_imagesinteger

Generated image count when returned.

usage.audio_duration_secondsnumber

Audio duration used for billing when returned.

usage.video_duration_secondsnumber

Video duration used for billing when returned.

usage.provider_request_idstring

Provider request ID used for upstream correlation.

Additional fields may appear, such as resolution, fileformat, frames, generate_audio, or response.*, depending on the model.

Polling Behavior

  • queued: the task has been accepted and is waiting to start.
  • in_progress: generation is running. Continue polling.
  • completed: the result is ready. Read url or video_url for the generated video.
  • failed: generation failed. Read error.code and error.message.

Request

Shell
1curl https://api.token360.ai/v1/videos/your-video-id \
2  -H "Authorization: Bearer sk-your-api-key"

Use the id from the submit response as video_id.

Response

JSON
1{
2  "id": "your-video-id",
3  "object": "video",
4  "status": "completed",
5  "model": "your-video-model",
6  "prompt": "Add gentle motion to the scene",
7  "created_at": 1776352017,
8  "updated_at": 1776352105,
9  "duration": 4,
10  "resolution": "720p",
11  "progress": 100,
12  "parameters": {
13    "duration": 4,
14    "resolution": "720p",
15    "aspect_ratio": "16:9",
16    "video_mode": "i2v_first_frame"
17  },
18  "url": "your-video-url",
19  "video_url": "your-video-url"
20}
Was this page helpful?