创建 Seedance 视频任务 - InfinityBlue API

curl --request POST \
  --url https://api.getinfinityblue.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "一只白色小猫在干净的书桌上慢慢走动，柔和日光，电影感镜头，画面稳定",
  "seconds": "5",
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": false,
  "watermark": false,
  "camera_fixed": false
}
'

{
  "id": "video_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1764347090922,
  "seconds": "5"
}

POST

videos

curl --request POST \
  --url https://api.getinfinityblue.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "一只白色小猫在干净的书桌上慢慢走动，柔和日光，电影感镜头，画面稳定",
  "seconds": "5",
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": false,
  "watermark": false,
  "camera_fixed": false
}
'

{
  "id": "video_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1764347090922,
  "seconds": "5"
}

可用模型

模型 ID	说明
`doubao-seedance-2-0-260128`	Seedance 2.0 标准版，质量更高
`doubao-seedance-2-0-fast-260128`	Seedance 2.0 Fast 版，速度更快、成本更低

调用流程

POST /v1/videos — 提交任务，获取 id（即 task_id）
GET /v1/videos/{task_id} — 轮询，直到 status=completed
从 metadata.url 读取视频 URL，或通过 GET /v1/videos/{task_id}/content 直接下载视频流

参数优先级

推荐使用顶层参数（seconds、resolution、ratio 等），不要与 metadata 中的同名字段同时传入，否则行为由服务端决定。

多模态素材

首尾帧、参考视频、参考音频等复杂场景，使用 metadata.content 精确声明每个素材的类型（image_url / video_url / audio_url）和用途（role）。包含 video_url 时，费用按视频输入规则计算。

分辨率说明

480p：成本低、速度快，适合草稿和预览
720p：适合常规生产
1080p：可用性取决于上游账号权限，生产环境请先实测

授权

Authorization

string

header

必填

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

请求体

application/json

Seedance 2.0 视频生成请求。model 与 prompt 为必填字段。推荐将常用参数放在请求顶层，metadata 仅用于兼容旧写法和复杂多模态素材。

model

enum<string>

必填

模型 ID。普通版质量更高，Fast 版生成速度更快、成本更低。

可用选项:

doubao-seedance-2-0-260128,

doubao-seedance-2-0-fast-260128

示例:

"doubao-seedance-2-0-260128"

prompt

string

必填

文本描述提示词。建议包含主体、动作、场景、镜头、光线、风格、约束条件。多模态参考素材可在提示词中用"视频 1"、"图片 1"、"音频 1"等方式指代。

示例:

"一只白色小猫在干净的书桌上慢慢走动，柔和日光，电影感镜头，画面稳定"

seconds

enum<string>

推荐使用。视频时长，单位秒，建议传字符串（如 "5"）。 Seedance 2.0 通常支持 4 到 15 秒。不要与 duration 或 metadata.duration 同时传入。

可用选项:

4,

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15

示例:

"5"

duration

number

兼容字段。视频时长，单位秒。新接入推荐使用顶层 seconds，不要与 seconds 或 metadata.duration 同时传入。

必填范围: 4 <= x <= 15

示例:

5

resolution

enum<string>

推荐使用。输出分辨率。480p 成本低速度快；720p 适合常规生产； 1080p 可用性取决于上游账号权限，生产环境请先实测。

可用选项:

480p,

720p,

1080p

示例:

"720p"

ratio

enum<string>

推荐使用。输出画面比例。adaptive 或 auto 表示跟随输入素材比例；无输入素材时建议显式指定具体比例。

可用选项:

adaptive,

auto,

21:9,

16:9,

4:3,

1:1,

3:4,

9:16

示例:

"16:9"

size

string

Sora 兼容字段，格式如 1280x720。新接入建议优先使用顶层 resolution + ratio，避免尺寸与上游枚举不匹配。

示例:

"1280x720"

image

string

单张参考图片，URL 或 Base64。适合简单图生视频/首帧参考。多图、首尾帧或角色参考建议使用 metadata.content。

示例:

"https://example.com/image.jpg"

ref_images

string[]

参考图片数组，URL 或 Base64。需要明确首帧、尾帧、普通参考图角色时，建议使用 metadata.content。

示例:

[
  "https://example.com/reference-1.jpg",
  "https://example.com/reference-2.jpg"
]

generate_audio

boolean

默认值:false

推荐使用。是否生成同步音频。开启后可能增加生成时间。需要对白时，建议在 prompt 中明确台词、语气和声音环境。

示例:

false

watermark

boolean

默认值:false

推荐使用。是否添加水印。对外 API 服务通常建议关闭。

示例:

false

camera_fixed

boolean

默认值:false

推荐使用。是否固定镜头。适合商品展示、稳定构图、监控视角等场景。开启后可减少镜头漂移。

示例:

false

return_last_frame

boolean

默认值:false

推荐使用。是否返回视频最后一帧。适合连续生成场景，可将上一段最后一帧作为下一段的首帧参考。

示例:

false

seed

integer<int64>

随机种子。相同模型、相同素材、相同参数与相同 seed 通常结果更接近，但不保证完全一致。

示例:

20231234

integer

默认值:1

生成视频数量。视频异步任务建议固定为 1；需要多条视频时，建议提交多个独立任务以便追踪和计费。

必填范围: 1 <= x <= 1

示例:

1

response_format

enum<string>

默认值:url

响应格式，建议使用 url。

可用选项:

url

示例:

"url"

user

string

用户标识，用于业务侧审计和风控，不参与生成。

示例:

"user-1234"

metadata

object

Seedance 2.0 扩展参数。一般情况下不建议将常用参数放入 metadata，请优先使用请求顶层的对应字段。metadata.content 仍建议用于视频参考、音频参考、首尾帧等复杂多模态素材。

Show child attributes

响应

成功创建 Seedance 视频任务

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

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 视频任务错误信息。

Show child attributes

metadata

object

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

Show child attributes

NanoBanana（OpenAI 格式）Seedance 2.0 — 查询状态

⌘I

​可用模型

​调用流程

​参数优先级

​多模态素材

​分辨率说明

授权

请求体

响应

可用模型

调用流程

参数优先级

多模态素材

分辨率说明