Seedance 2.0 视频生成 API 参考

Seedance 2.0 视频生成 API 参考与在线调试：文生视频 / 首尾帧 / 首帧 / 多模态参考生视频，异步任务式端点，含完整轮询与下载代码。

POST /seedance/api/v3/contents/generations/tasks

创建 Seedance 2.0 视频生成任务

cURL

curl --request POST \
  --url https://api.apiyi.com/seedance/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感"
    }
  ]
}
'

import requests

url = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"

payload = {
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'doubao-seedance-2-0-fast-260128',
    content: [{type: 'text', text: '无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感'}]
  })
};

fetch('https://api.apiyi.com/seedance/api/v3/contents/generations/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'doubao-seedance-2-0-fast-260128',
    'content' => [
        [
                'type' => 'text',
                'text' => '无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"

	payload := strings.NewReader("{\n  \"model\": \"doubao-seedance-2-0-fast-260128\",\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.apiyi.com/seedance/api/v3/contents/generations/tasks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"doubao-seedance-2-0-fast-260128\",\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apiyi.com/seedance/api/v3/contents/generations/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"doubao-seedance-2-0-fast-260128\",\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

{
  "id": "cgt-20260606160057-6bbjd"
}

右侧 Playground 可直接调试：在 Authorization 填 Bearer sk-your-api-key（令牌须勾选 SeeDance2 分组），填好 model / content 后发起请求。提交成功返回任务 id，后续轮询与下载见下方代码示例。

关于 Playground 报「请求时发生错误: no response received」：本接口是异步任务式端点，在浏览器里点「发送」可能出现此提示——这是浏览器的跨域安全校验拦截了响应，任务实际已成功提交到后台（可用下方查询接口或控制台日志验证）。此外 Playground 仅能创建任务、无法完成轮询与下载视频。要跑通完整的「创建 → 轮询 → 下载」流程，请直接复制下方 代码示例（cURL / Python / Node.js）运行。

本页是 Seedance 2.0 的创建任务接口，文生视频、首尾帧/首帧、多模态参考生视频共用同一端点，靠 content 数组区分模式。模型选型、定价、分辨率像素表、FAQ 见 Seedance 2.0 概览。

• 路径前缀是 /seedance/api/v3，不要漏掉 /api，也不要用 /v1/videos
• 令牌必须勾选 SeeDance2 分组，否则报「该模型无可用渠道」
• generate_audio 默认 true（输出带声音），不需要请显式传 false
• Python requests 需加请求头 "Accept-Encoding": "identity"，否则可能报 gzip 解码错误，或响应体被截断成非法 JSON（如开头丢失 {"，只剩 id":"cgt-xxx"}），甚至间歇性 400
• 成功状态是 succeeded（不是 completed），视频地址在 content.video_url，24 小时过期

​

代码示例

cURL（文生视频）

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      {"type": "text", "text": "无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感"}
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'
# 返回：{"id":"cgt-2026xxxx-xxxxx"}，拿 id 轮询查询接口

import time
import requests

BASE = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"
HEADERS = {
    "Authorization": "Bearer sk-your-api-key",
    "Content-Type": "application/json",
    # 必加：网关 gzip 头与实际编码不符，缺了会报 gzip 解码错误，
    # 或响应体被截断成非法 JSON（如开头丢 {"，只剩 id":"cgt-xxx"}），甚至间歇 400
    "Accept-Encoding": "identity",
}

# 1. 创建任务
body = {
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {"type": "text", "text": "海浪拍打礁石，夕阳把海面染成金色，慢镜头，氛围宁静"}
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    # "generate_audio": False,  # 默认 True；不要声音时取消注释
    # "seed": 12345,            # 固定随机性，可复现类似结果
}
task_id = requests.post(BASE, json=body, headers=HEADERS, timeout=60).json()["id"]
print("task_id:", task_id)

# 2. 轮询直到终态（succeeded / failed / expired）
while True:
    time.sleep(20)
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    status = task.get("status")
    print("status:", status)
    if status in ("succeeded", "failed", "expired"):
        break

# 3. 下载视频（URL 24 小时过期，成功后立即转存）
if status == "succeeded":
    video_url = task["content"]["video_url"]   # 注意：在 content 下，不在顶层
    print("tokens:", task["usage"]["completion_tokens"])
    with requests.get(video_url, stream=True, timeout=300) as r:
        r.raise_for_status()
        with open(f"{task_id}.mp4", "wb") as f:
            for chunk in r.iter_content(chunk_size=1 << 20):
                f.write(chunk)
    print(f"已保存 {task_id}.mp4")
else:
    print("任务未成功:", task.get("error"))

# 首尾帧：2 张图，role 必填；与参考图模式互斥
body_first_last = {
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {"type": "text", "text": "画面从第一帧平滑过渡到最后一帧，镜头缓慢运动"},
        {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"},
         "role": "first_frame"},
        {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"},
         "role": "last_frame"},
    ],
    "resolution": "720p",
    "ratio": "adaptive",   # 按首帧图片比例自动适配，避免裁剪
    "duration": 5,
}

# 多模态参考：0~9 参考图 + 0~3 参考视频 + 0~3 参考音频（至少 1 图或 1 视频），可生成全新/编辑/延长视频
body_reference = {
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {"type": "text", "text": "以参考图的角色和风格，生成角色在雨夜街头行走的镜头"},
        {"type": "image_url", "image_url": {"url": "https://example.com/character.png"},
         "role": "reference_image"},
        # {"type": "video_url", "video_url": {"url": "..."}, "role": "reference_video"},
        # {"type": "audio_url", "audio_url": {"url": "..."}, "role": "reference_audio"},
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
}
# 图片也支持 Base64（data:image/png;base64,xxx）与平台素材 ID（asset://xxx）

const BASE = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks";
const HEADERS = {
  "Authorization": "Bearer sk-your-api-key",
  "Content-Type": "application/json",
};

// 1. 创建任务
const { id } = await fetch(BASE, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    model: "doubao-seedance-2-0-fast-260128",
    content: [{ type: "text", text: "雪山脚下的湖泊倒映着星空，延时摄影效果" }],
    resolution: "720p",
    ratio: "9:16",        // 竖屏与横屏同价
    duration: 5,
  }),
}).then(r => r.json());
console.log("task_id:", id);

// 2. 轮询直到终态
let task;
do {
  await new Promise(r => setTimeout(r, 20000));
  task = await fetch(`${BASE}/${id}`, { headers: HEADERS }).then(r => r.json());
  console.log("status:", task.status);
} while (!["succeeded", "failed", "expired"].includes(task.status));

// 3. 视频直链（24 小时过期，请立即转存）
if (task.status === "succeeded") console.log(task.content.video_url);

curl "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/cgt-2026xxxx-xxxxx" \
  -H "Authorization: Bearer sk-your-api-key"

​

参数说明速查

参数	类型	必填	默认	说明
model	string	✓	—	doubao-seedance-2-0-260128（标准版，支持 1080p）/ doubao-seedance-2-0-fast-260128（极速版，最高 720p）/ doubao-seedance-2-0-mini-260615（轻量版，最高 720p，单价约标准版一半）。写纯 ID，不要带 ep- 前缀
content	array	✓	—	输入信息数组，见下方「生成模式」
resolution	string		720p	480p / 720p / 1080p（1080p 仅标准版，fast 与 mini 最高 720p）
ratio	string		adaptive	16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive；同档位全比例同价
duration	int		5	4–15 整数秒；-1 模型智能选时长（按实际产出计费）
generate_audio	bool		true	是否生成同步音频（人声/音效/配乐，单声道）
watermark	bool		false	是否加「AI 生成」水印
seed	int		-1	[-1, 2^32-1]；相同 seed 生成类似（不保证一致）结果
return_last_frame	bool		false	返回尾帧 png（无水印），用于多段视频接力
execution_expires_after	int		172800	任务过期阈值（秒），范围 [3600, 259200]

Seedance 2.0 不支持 frames、camera_fixed、service_tier（仅在线推理）参数——这些是 Seedance 1.x 的能力，传入会被忽略或报错。

​

生成模式（content 组合）

模式	content 组成	role 取值
文生视频	1 个 text	—
图生视频-首尾帧	text（可选）+ 2 个 image_url	必填 first_frame / last_frame
图生视频-首帧	text（可选）+ 1 个 image_url	first_frame 或不填
多模态参考生视频	text + 0–9 个 image_url（+ 可选 0–3 个 video_url / 0–3 个 audio_url，至少 1 图或 1 视频）	reference_image / reference_video / reference_audio

三种图生场景互斥。图片支持公网 URL、Base64（data:image/png;base64,...）、素材 ID（asset://...）；不支持含真人人脸的输入素材。音频需与至少 1 个图片或视频一起传。素材引用的端到端代码（上传入库 → asset:// 出片 → 下载）见 素材引用实战。

​

响应格式

创建成功只返回任务 ID（不是视频本身）：

{ "id": "cgt-20260606160057-6bbjd" }

轮询 GET /seedance/api/v3/contents/generations/tasks/{id}，成功后的完整响应（实测样本）：

{
  "id": "cgt-20260606160057-6bbjd",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/....mp4?X-Tos-Expires=86400&..."
  },
  "usage": { "completion_tokens": 108900, "total_tokens": 108900 },
  "created_at": 1780732857,
  "updated_at": 1780732991,
  "seed": 97151,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "draft": false
}

• 视频地址在 content.video_url，不在顶层；签名直链 24 小时过期，成功后立即下载转存
• 状态机：queued → running → succeeded / failed / expired，成功是 succeeded
• 下载视频时直接 GET 直链即可，不要带 Authorization 头

usage.completion_tokens 即计费 token 数，满足 token ≈ 时长 × 宽 × 高 × 24 / 1024（实测偏差少于 0.1%）。duration: -1 或 ratio: adaptive 时，实际时长与比例以响应中的 duration / ratio 字段为准。

授权

Authorization · string · header · 必填

在 API易控制台获取的 API Key（令牌须勾选 SeeDance2 分组）

请求体

application/json

model · enum<string> · 必填

模型 ID（写纯 ID，不要带 ep- 前缀）。标准版支持 1080p；fast 最高 720p，生成更快，站内同价

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

示例:

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

content · object[] · 必填

输入信息数组。文生视频只放 1 个 text；图生视频追加 image_url（role: first_frame / last_frame）；多模态参考生视频追加 0-9 个 image_url（role: reference_image），可再加 0-3 个 video_url / 0-3 个 audio_url（至少 1 图或 1 视频，支持生成全新/编辑/延长视频）。三种图生场景互斥

Show child attributes

resolution · enum<string> · 默认值: 720p

分辨率档位（定义像素面积，同档位全比例同价）。fast 不支持 1080p

可用选项: 480p, 720p, 1080p

ratio · enum<string> · 默认值: adaptive

宽高比。adaptive 按输入自动适配（图生视频推荐，避免裁剪）；实际比例见查询响应 ratio 字段

可用选项: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

duration · integer · 默认值: 5

视频时长（整数秒），4-15；或 -1 由模型智能选择（按实际产出计费）。费用与时长线性相关

示例:

5

generate_audio · boolean · 默认值: true

是否生成与画面同步的音频（人声/音效/背景音乐，单声道）。注意默认 true，不需要声音时显式传 false

watermark · boolean · 默认值: false

是否在右下角加「AI 生成」水印

seed · integer · 默认值: -1

随机种子，[-1, 2^32-1]。相同 seed 生成类似（不保证一致）结果；-1 表示随机

return_last_frame · boolean · 默认值: false

是否返回尾帧 png（无水印、与视频同宽高），用于把尾帧作为下一段任务首帧、量产连续视频

execution_expires_after · integer · 默认值: 172800

任务过期阈值（秒），超时任务标记为 expired。范围 [3600, 259200]

响应

200

application/json

任务创建成功，返回任务 ID（用于轮询查询）

任务创建成功响应。拿 id 轮询 GET /seedance/api/v3/contents/generations/tasks/{id}；任务成功后视频地址在 content.video_url（24 小时过期），计费 token 在 usage.completion_tokens

id · string

视频生成任务 ID（保存 7 天）

示例:

"cgt-20260606160057-6bbjd"