Skip to main content
GET
/
byteplus
/
api
/
v3
/
contents
/
generations
/
tasks
/
{id}
request
curl --request GET \
  --url https://api.powertokens.ai/byteplus/api/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "cgt-2026****-****",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1779348818,
  "updated_at": 1779348874,
  "seed": 78674,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "generate_audio": true,
  "draft": false,
  "priority": 0
}

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <token> in the request header.

Headers

​
Content-Type
string
default:application/json

The content type of the request.

Path Parameters

​
id
string
required

The ID of the video generation task to query.

Note: The above parameter is a Query String Parameter, passed in the URL String.

Response

response

​
id
string

The ID of the video generation task.

​
model
string

The name and version of the model used by the task (Model name-Version).

​
status
enum<string>

The status of the task. Valid values:

  • queued: In queue.
  • running: Task is running.
  • cancelled: Task cancelled (Only tasks in the queued state can be canceled). Cancelled status is automatically deleted after 24h.
  • succeeded: Task succeeded.
  • failed: Task failed.
  • expired: Task timed out.
Available options:
queued,
running,
cancelled,
succeeded,
failed,
expired
​
error
object

The error information. If the task succeeds, null is returned. If the task fails, the error information is returned.

​
created_at
integer

The time when the task was created. The value is a Unix timestamp in seconds.

​
updated_at
integer

The time when the task was last updated. The value is a Unix timestamp in seconds.

​
content
object

The output after the video generation task is completed.

​
seed
integer

The seed value (integer) used for this request.

​
resolution
string

The resolution of the generated video.

​
ratio
string

The width-to-height ratio of the generated video.

​
duration
integer

The length of the generated video in seconds.

Note: Only one of the duration and frames parameters is returned. If frames is not specified in the creating video generation request, duration will be returned.

​
frames
integer

Number of frames for the generated video.

Note: Only one of the duration and frames parameters will be returned. If frames is specified in the creating video generation request, frames will be returned.

​
framespersecond
integer

The frame rate of the generated video.

​
generate_audio
boolean

Whether the generated video includes audio synchronized with the visuals. This parameter is only supported by seedance 2.0 & 2.0 fast, and seedance 1.5 pro.

  • true: The model outputs a video with synchronized audio.
  • false: The model outputs a silent video.
​
tools
object[]

The tools actually used by the model for this request. Not returned when no tools are used.

​
safety_identifier
string

A unique identifier for the end user. If you set this parameter when creating a video generation task, the API returns it unchanged.

​
priority
integer

The execution priority of the current request.

​
draft
boolean

Whether the generated video is a draft video. This parameter is only returned by seedance 1.5 pro.

  • true: The current output is a draft video.
  • false: The current output is a standard video.
​
draft_task_id
string

Draft video task ID. This parameter will be returned when generating an official video based on a draft video.

​
service_tier
string

The service tier actually used to process the task.

​
execution_expires_after
integer

The expiration threshold for the task, in seconds.

​
usage
object

The token usage for the request.