跳转到主要内容
GET
/
v1
/
videos
/
{task_id}
获取 Seedance 视频任务状态
curl --request GET \
  --url https://api.getinfinityblue.com/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1764347090922,
  "seconds": "5"
}

​
任务状态说明

状态含义
queued排队等待处理
in_progress生成中，progress 字段反映百分比进度
completed已完成，视频 URL 位于 metadata.url
failed生成失败，查看 error 字段了解原因

​
轮询建议

Seedance 任务通常在 30 秒至数分钟内完成。 建议每 5–10 秒轮询一次，并结合 progress 字段提示用户进度。

​
获取视频

完成后有两种方式获取视频：
  • 直接使用 metadata.url 中的 CDN 链接（有效期见 expires_at）
  • 调用 GET /v1/videos/{task_id}/content 通过接口代理下载

授权

​
Authorization
string
header
必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

路径参数

​
task_id
string
必填

视频任务 ID，由创建接口返回的 id 字段。

响应

成功获取视频任务状态

Seedance 视频任务对象，兼容 OpenAI / Sora 视频任务格式。

​
id
string
必填

视频任务 ID。

示例:

"video_abc123"

​
object
enum<string>
必填

对象类型，固定为 video。

可用选项:
video
示例:

"video"

​
model
enum<string>
必填

执行任务所用的模型。

可用选项:
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128
示例:

"doubao-seedance-2-0-fast-260128"

​
status
enum<string>
必填

任务状态。

可用选项:
queued,
in_progress,
completed,
failed
示例:

"queued"

​
progress
integer
必填

任务进度百分比（0–100）。

必填范围: 0 <= x <= 100
示例:

0

​
created_at
integer<int64>
必填

任务创建时间戳（毫秒）。

示例:

1764347090922

​
seconds
string
必填

视频时长，单位秒。

示例:

"5"

​
completed_at
integer<int64>

任务完成时间戳（毫秒），完成后填充。

示例:

1764347170000

​
expires_at
integer<int64>

任务及视频文件的过期时间戳（毫秒）。

示例:

1764433570000

​
size
string

视频尺寸，格式如 1280x720。

示例:

"1280x720"

​
error
object

Seedance 视频任务错误信息。

​
metadata
object

额外元数据，任务完成后通常包含 url 字段。