跳转到主要内容
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
}

授权

Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>

请求头

Content-Type
string
默认值:application/json

请求内容类型。

路径参数

id
string
必填

您需要查询的视频生成任务的 ID 。

说明:上面参数为Query String Parameters,在URL String中传入。

响应

response

id
string

视频生成任务 ID。

model
string

任务使用的模型名称和版本,模型名称-版本

status
enum<string>

任务状态,以及相关的信息:

  • queued:排队中。
  • running:任务运行中。
  • cancelled:取消任务,取消状态24h自动删除(只支持排队中状态的任务被取消)。
  • succeeded: 任务成功。
  • failed:任务失败。
  • expired:任务超时。
可用选项:
queued,
running,
cancelled,
succeeded,
failed,
expired
error
object

错误提示信息,任务成功返回null,任务失败时返回错误数据

created_at
integer

任务创建时间的 Unix 时间戳(秒)。

updated_at
integer

任务当前状态更新时间的 Unix 时间戳(秒)。

content
object

视频生成任务的输出内容。

seed
integer

本次请求使用的种子整数值。

resolution
string

生成视频的分辨率。

ratio
string

生成视频的宽高比。

duration
integer

生成视频的时长,单位:秒。

说明:duration 和 frames 参数只会返回一个。创建视频生成任务时未指定 frames,会返回 duration。

frames
integer

生成视频的帧数。

说明:duration 和 frames 参数只会返回一个。创建视频生成任务时指定了 frames,会返回 frames。

framespersecond
integer

生成视频的帧率。

generate_audio
boolean

生成的视频是否包含与画面同步的声音。仅 seedance 2.0 & 2.0 fast、seedance 1.5 pro 会返回该参数。

  • true:模型输出的视频包含同步音频。
  • false:模型输出的视频为无声视频。
tools
object[]

本次请求模型实际使用的工具。未使用工具时不返回。

safety_identifier
string

终端用户的唯一标识符。若 创建视频生成任务 时设置了该参数,接口会原样返回此信息。

priority
integer

当前请求的执行优先级。

draft
boolean

生成的视频是否为 Draft 视频。仅 seedance 1.5 pro 会返回该参数。

  • true:表示当前输出为 Draft 视频。
  • false:表示当前输出为正常视频。
draft_task_id
string

Draft 视频任务 ID。基于 Draft 视频生成正式视频时,会返回该参数。

service_tier
string

实际处理任务使用的服务等级。

execution_expires_after
integer

任务超时阈值,单位:秒。

usage
object

本次请求的 token 用量。