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"