Token360

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.

Available options: queued in_progress completed 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.

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 by the provider.

content.last_frame_urlstring

Last-frame image URL when return_last_frame=true and the provider returns it.

errorobject

Error details when status=failed.

error.codestring

Provider or platform error code.

error.messagestring

Human-readable error message.

Additional provider-specific fields may appear (e.g. resolution, fileformat, frames, generate_audio, response.*) depending on the model's provider.

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": "seedance-2.0",
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?