SEEDANCE / 旗舰视频生成

Seedance API 用法

火山方舟豆包 Seedance 系列旗舰视频生成模型。通过 nexusflow 统一 /v1/tasks 异步任务接口调用，与现有 wan2.6、happyhorse、pixverse 等视频模型同协议。Seedance 2.0 旗舰版为系列最厉害的模型，支持多模态参考生视频、4K HDR 10bit、有声视频与首尾帧控制。

Seedance 2.0 旗舰版 · 系列最强

支持 4K HDR 10bit 输出、多模态参考生视频（0-9 图 + 0-3 视频 + 0-3 音频）、有声视频自动生成、首尾帧控制、21:9 全比例、队列优先级等独有能力。详见模型介绍 →

支持的模型

模型 ID

名称 / 模式

有声

起步价

seedance-2.0旗舰

豆包 Seedance 2.0 旗舰版

文生 / 首帧 / 首尾帧 / 多模态参考

✓

¥0.44 起 / 秒

seedance-2.0-fast

豆包 Seedance 2.0 Fast

文生 / 首帧 / 多模态参考

✓

—

¥0.36 起 / 秒

seedance-2.0-mini

豆包 Seedance 2.0 Mini

文生 / 首帧 / 多模态参考

✓

—

¥0.22 起 / 秒

seedance-1.5-pro

豆包 Seedance 1.5 Pro

文生 / 首帧 / 首尾帧

✓

—

¥0.17 起 / 秒

seedance-1.0-pro

豆包 Seedance 1.0 Pro

文生 / 首帧 / 首尾帧

—

¥0.14 起 / 秒

seedance-1.0-pro-fast

豆包 Seedance 1.0 Pro Fast

文生 / 首帧

—

¥0.04 起 / 秒

HTTP 调用流程

创建任务获取 task_id

POST /v1/tasks

根据 task_id 轮询结果

GET /v1/tasks/{task_id}

请求参数

参数

类型

必填

说明

model

string

必填

Seedance 模型 ID：seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini / seedance-1.5-pro / seedance-1.0-pro / seedance-1.0-pro-fast。

prompt

string

可选

文本提示词。建议写清主体、动作、镜头与风格。多模态参考生视频场景下可选。

img_url

string

可选

首帧图片 URL（JPG/PNG/WEBP）。图生视频-首帧模式必填，图生视频-首尾帧模式作为首帧。

img_end_url

string

可选

尾帧图片 URL。与 img_url 同时传入即启用首尾帧模式。

img_urls

string[]

可选

参考图片 URL 数组（0-9 张）。仅 Seedance 2.0 系列多模态参考生视频场景。

video_urls

string[]

可选

参考视频 URL 数组（0-3 段）。仅 Seedance 2.0 系列多模态参考生视频场景。

audio_urls

string[]

可选

参考音频 URL 数组（0-3 段）。仅 Seedance 2.0 系列多模态参考生视频场景。

resolution

string

可选

分辨率：480p / 720p（默认）/ 1080p / 4k（仅 2.0）。Seedance 2.0 Fast 不支持 1080p 与 4k。

ratio

string

可选

宽高比：16:9（默认）/ 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive（2.0、1.5 Pro 智能）。

duration

integer

可选

视频时长（秒）。2.0 系列 [4, 15] 或 -1 智能指定；1.5 Pro [4, 12] 或 -1；1.0 Pro Fast [2, 12]。默认 5。

generate_audio

boolean

可选

是否生成有声视频，默认 true。仅 2.0 系列、1.5 Pro 支持。对话建议置于双引号内优化音频效果。

draft

boolean

可选

是否开启样片模式（480p 预览视频），默认 false。仅 1.5 Pro 支持。

return_last_frame

boolean

可选

是否返回生成视频的尾帧图像（PNG），默认 false。可用于多段视频连续生成。

watermark

boolean

可选

是否添加 AI 生成水印，默认 false。

seed

integer

可选

随机种子 [-1, 2^32-1]。Seedance 2.0 系列暂不支持。

camera_fixed

boolean

可选

是否固定摄像头，默认 false。参考图场景与 2.0 系列不支持。

service_tier

string

可选

服务等级：default（在线推理，默认）/ flex（离线推理，价格为 50%）。仅 1.5 Pro 与 1.0 系列支持。

callback_url

string

可选

任务结果回调通知地址。任务状态变化时方舟会向此地址 POST 任务详情。

priority

integer

可选

队列优先级 [0, 9]，数值越大优先级越高。仅 Seedance 2.0 系列支持。

调用示例

纯文本生成视频

# 步骤1：创建文生视频任务（Seedance 2.0 旗舰版，4K HDR 有声）
curl -X POST 'https://nexusflow.hk/v1/tasks' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "黄昏城市海岸线，镜头缓慢推进，电影感自然光，细腻真实风格",
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 10,
    "generate_audio": true,
    "watermark": false
  }'

# 返回 → { "id": "task_abc123...", "status": "running", ... }

# 步骤2：轮询查询结果（建议间隔 10-15 秒）
curl https://nexusflow.hk/v1/tasks/task_abc123 \
  -H "Authorization: Bearer $API_KEY"

# 返回 → { "status": "succeeded", "output": { "video_url": "https://...", "duration": 10, "resolution": "1080p" }, ... }

响应示例

任务成功后返回 output.video_url，URL 默认 24 小时有效。任务记录保留 7 天。

{
  "id": "task_abc123def456",
  "object": "task",
  "status": "succeeded",
  "model": "seedance-2.0",
  "type": "video",
  "progress": 100,
  "output": {
    "type": "video",
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...",
    "duration": 10,
    "resolution": "1080p",
    "ratio": "16:9",
    "generate_audio": true,
    "seed": 33608,
    "framespersecond": 24
  },
  "created_at": "2026-06-30T10:00:00.000Z",
  "completed_at": "2026-06-30T10:02:30.000Z"
}

使用注意

真人肖像限制：Seedance 2.0 系列不支持直接上传含真人人脸的参考图/视频。可使用预置虚拟人像、已授权真人素材或部分模型的含人脸原始产物作为输入。
多模态参考约束：参考生视频场景下不可单独输入音频，至少包含 1 张参考图或 1 段参考视频。
4K 播放兼容性：4K 视频采用 H.265 编码，少数播放环境可能不兼容。建议使用 VLC、MPV、QuickTime Player 等播放器查看。
时长与计费：duration 设为 -1 表示由模型智能选择时长（2.0 / 1.5 Pro 支持），实际时长会影响计费，请谨慎设置。
种子复现：相同请求 + 相同 seed 会生成类似结果，但不保证完全一致。Seedance 2.0 系列暂不支持 seed 参数。