Seedance 2.0 / 2.5 视频生成 API 参考

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）

# 2.5 与 2.0 共用同一端点与请求结构，只需换 model；以下三段是 2.5 独有的能力

# ① 30 秒长片：2.5 的 duration 上限是 30（2.0 系是 15）
body_30s = {
    "model": "doubao-seedance-2-5-260628",
    "content": [{"type": "text", "text": "无人机航拍飞越秋天的山谷，晨雾在林间流动，一镜到底"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 30,        # 别省略！2.5 的 duration 缺省是 -1，模型会自己选时长
}

# ② 视频编辑：ratio 必须 adaptive、duration 必须 -1，参考视频时长需在 4-30 秒
body_edit = {
    "model": "doubao-seedance-2-5-260628",
    "content": [
        # 提示词必须带编辑意图词：增加 / 加上 / 删除 / 去掉 / 修改 / 替换 / 改成
        {"type": "text", "text": "在 @视频1 中增加几只飞过的小鸟"},
        {"type": "video_url", "video_url": {"url": "https://example.com/source.mp4"},
         "role": "reference_video"},
    ],
    "resolution": "720p",
    "ratio": "adaptive",                    # 必须；传具体比例会同步 400
    "duration": -1,                         # 必须；传具体秒数会同步 400
    "omni_reference_task_type": "edit",     # 显式声明，把参数校验前置到提交时
    "output_format": "mov",                 # 可选：后期加工推荐 mov（部分播放器不兼容）
}

# ③ 视频延长：ratio 必须 adaptive
body_extend = {
    "model": "doubao-seedance-2-5-260628",
    "content": [
        # 提示词必须带延长意图词：向前/向后延长、延续、续写
        {"type": "text", "text": "向后延长 @视频1，镜头继续向前推进，天色渐暗"},
        {"type": "video_url", "video_url": {"url": "https://example.com/source.mp4"},
         "role": "reference_video"},
    ],
    "resolution": "720p",
    "ratio": "adaptive",
    "omni_reference_task_type": "extend",
}

# ④ 纯音频参考：2.5 独有，2.0 系必须搭配图片或视频
body_audio_only = {
    "model": "doubao-seedance-2-5-260628",
    "content": [
        {"type": "text", "text": "根据 @音频1 的节奏，生成抽象光影随节拍律动的画面"},
        {"type": "audio_url", "audio_url": {"url": "https://example.com/track.mp3"},
         "role": "reference_audio"},
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
}
# 提交与轮询流程与上面完全一致，不再重复

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"