Seedance 官轉影片 API 規範

本頁是 Seedance 官轉影片模型的呼叫規範。這些模型與其他影片模型共用 POST /v1/videos 建立、GET /v1/videos/{id} 輪詢的流程；驗證、素材上傳、輪詢狀態、結果下載與錯誤處理請見影片 API 完整呼叫規範，本頁只列出這組模型專屬的欄位與規則。

更新於 2026-10-13。這組模型由火山引擎 Seedance 官方介面轉發，與 Seedance 官方版、SD 雲廠商版 屬於不同的模型組，參數與能力不能通用。本組模型不支援 callback_url：請求中帶有非空的 callback_url 會回傳 400，不建立任務、不扣費（空字串視為未填寫）；請透過 GET /v1/videos/{id} 輪詢取得結果。

模型一覽

下表列出這組模型的 model ID，只對已開通對應群組的 API Key 顯示；未開通時 GET /v1/models 不會回傳這些 ID。

先前的模型 ID doubao-seedance-2-0-mini-260615、doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-5-260628 仍可呼叫，與上表同名模型完全相同；它們已不在模型廣場顯示，新串接請使用上表的 ID。

通用規則

• 解析度：以 resolution 選擇輸出規格，可用值見上表（不分大小寫，例如 720p、4k），預設為 720p。
• 時長：duration（或 seconds）填整數秒；-1 代表由模型自動決定時長。
• 比例：ratio（或 aspect_ratio）可選 16:9、4:3、1:1、3:4、9:16、21:9、adaptive，預設為 adaptive（依輸入素材自動調整）。size 也可以填寫比例或解析度規格（例如 16:9、1080p），與 ratio、aspect_ratio 或 resolution 衝突時回傳 400。
• 提示詞：提供參考素材或首尾影格時可以省略 prompt；兩者都沒有會回傳 400。
• 生成音訊：generate_audio（布林值）設為 false 可關閉音訊，未傳時預設帶音訊。
• 選填欄位：watermark（布林值，true 時在右下角加上「AI 生成」浮水印，預設不加）、priority（0–9 的整數，排隊優先順序）、return_last_frame（布林值，見尾影格）。
• 不支援的欄位：seed、camera_fixed、frames、service_tier，傳送會回傳 400；draft 僅 Seedance 2.5 支援，見樣片與正式影片。

計費說明

這組模型依任務完成後模型平台回傳的輸出 Token 結算，套用「解析度 × 是否帶參考影片」對應的單價級距。提交時不預扣費用，使用紀錄中會先出現一筆「操作 …」的提交紀錄（金額為 0），任務完成後再出現一筆「任务用量表达式结算」紀錄，依實際用量扣費。

由模型決定時長時（duration 為 -1，或 Seedance 2.5 未填寫時長），提交紀錄裡的秒數是依最大時長估算的預估值，顯示為「seconds: 30（预估）」；實際扣費以結算紀錄為準。失敗或已取消的任務不扣費。

參考素材

• 參考圖片放在 images 陣列，參考影片放在 metadata.referenceVideos，參考音訊放在 metadata.referenceAudios。
• 也可以使用單數欄位：image、input_reference 作為參考圖片，video 作為參考影片，audio 作為參考音訊。同一素材在多個欄位重複填寫只計一次。
• 每一項可以是 URL 字串，也可以是 { "url": "...", "role": "..." }。
• 圖片接受公開的 https:// URL 或 data: Data URI；音訊接受公開的 https:// URL 或 data: Data URI。
• 參考影片只接受公開的 https:// URL，不接受 http://、data:、Base64 或本機檔案；本機影片請先依本機素材上傳取得 URL。連結必須免登入即可存取，並在任務完成前保持有效。
• 2.0 系列（Mini、2.0、Fast）不能只傳參考音訊，必須同時提供參考圖片或參考影片。
• 參考影片與音訊的累計時長，建議 2.0 系列各不超過 15 秒、2.5 各不超過 30 秒；超出時任務可能在提交後才回報失敗。
• 也可以直接使用火山方舟的 content 陣列寫法（text、image_url、video_url、audio_url 內容項，圖片 role 可為 first_frame、last_frame 或 reference_image），放在頂層或 metadata 中皆可。

{
  "model": "doubao-seedance-2.0",
  "prompt": "參考圖中的人物隨參考音訊的節奏起舞，動作風格參考參考影片",
  "duration": 8,
  "resolution": "1080p",
  "ratio": "16:9",
  "images": ["https://cdn.example.com/dancer.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/dance-motion.mp4"],
    "referenceAudios": ["https://cdn.example.com/music.mp3"]
  }
}

虛擬人像庫（入庫模式）

預設情況下，參考素材會直接提交給生成介面審核。也可以先把素材放入虛擬人像庫，通過入庫審核後再用於生成：

• 圖片設定 "image_source_mode": "asset"，參考影片設定 "video_source_mode": "asset"（影片仍須是公開的 https:// URL）。兩個欄位可放在頂層或 metadata 中，彼此獨立。
• 以 multipart/form-data 上傳的本機圖片會自動放入虛擬人像庫並以入庫模式提交，不需另外設定，見檔案上傳。
• 入庫審核只檢查素材是否可用，不是本人實名、刷臉或活體驗證；目前不提供真人授權入庫流程，真人照片在入庫模式下也可能審核不通過。
• 目前不提供獨立的素材管理功能（單獨上傳、素材列表、素材 ID），每次生成請求都需要帶上素材。

{
  "model": "doubao-seedance-2.5",
  "prompt": "圖片 1 中的人物配戴圖片 2 的項鍊，在明亮的攝影棚中緩慢轉身展示",
  "duration": 6,
  "resolution": "720p",
  "ratio": "9:16",
  "image_source_mode": "asset",
  "images": [
    { "url": "https://cdn.example.com/model.png", "role": "reference_image" },
    { "url": "https://cdn.example.com/necklace.png", "role": "reference_image" }
  ]
}

多張參考圖片會依提交順序保留，請在提示詞中寫明「圖片 1」「圖片 2」各自對應的內容，避免人物或物品對應混淆。

首尾影格

首影格與尾影格放在 metadata.firstFrame 與 metadata.lastFrame，並計入圖片數量上限。

• lastFrame 必須與 firstFrame 同時提供。
• 首尾影格不能與參考圖片、參考影片或參考音訊混用。
• Seedance 2.5（多解析度）使用首尾影格時，ratio 必須為 adaptive（或不傳）。

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "從清晨空曠的廣場平順轉場到夜晚燈火亮起的同一構圖",
  "duration": 5,
  "resolution": "720p",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Seedance 2.5 的影片編輯與延長

Seedance 2.5（多解析度）在提供參考影片時，可以用 omni_reference_task_type 指定任務：

另外可用 output_format 選擇 mp4 或 mov。這兩個欄位只對 2.5 生效，2.0 系列傳送會回傳 400。

{
  "model": "doubao-seedance-2.5",
  "prompt": "把畫面中的白天改成雨夜，保留人物動作",
  "omni_reference_task_type": "edit",
  "duration": -1,
  "ratio": "adaptive",
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/source.mp4"]
  }
}

樣片與正式影片（Seedance 2.5）

Seedance 2.5（多解析度）可以先生成低成本的 480p 樣片，確認效果後再以樣片為基礎生成 1080p 正式影片。其他模型不支援樣片。

1. 生成樣片：請求中加上 "draft": true，輸出固定為 480p。樣片不能同時設定 return_last_frame。
2. 等待樣片成功：照常輪詢 GET /v1/videos/{id}，狀態為 completed 後檢視樣片。
3. 生成正式影片：content 中只放一個 draft_task，id 填樣片任務的 id（建立樣片時回傳的 task_…）。正式影片固定為 1080p，提示詞、素材、時長、比例、音訊等都從樣片沿用，不要重複傳送 prompt、素材、duration、ratio、generate_audio、omni_reference_task_type 或 return_last_frame，否則會回傳 400。

{
  "model": "doubao-seedance-2.5",
  "content": [
    { "type": "draft_task", "draft_task": { "id": "task_REPLACE_WITH_YOUR_DRAFT_TASK_ID" } }
  ],
  "watermark": false
}

• 只能使用本帳號建立且已成功的樣片任務；請在樣片建立後 7 天內生成正式影片。
• 樣片與正式影片是兩個獨立計費的任務；正式影片依 1080p 級距結算，樣片若帶參考影片，正式影片同樣依帶參考影片的級距結算。

尾影格

請求中設定 "return_last_frame": true，任務成功後即可取得影片最後一格的圖片，用於接續拍攝或作為下一段影片的首影格：

curl https://api.88api.ai/v1/tasks/task_xxx/artifacts \
  -H "Authorization: Bearer sk-你的API金鑰"

回傳的 artifacts 中，key 為 last_frame 的項目即為尾影格圖片，請依其 content_url 下載（同樣需攜帶 API Key）。尾影格不會出現在 GET /v1/videos/{id} 的回應中。圖片格式以下載結果的 Content-Type 為準，不保證是 PNG。

聯網搜尋

Seedance 2.0 系列與 2.5 支援以 tools 進行聯網搜尋，適合需要即時資訊的提示詞：

{
  "model": "doubao-seedance-2.0",
  "prompt": "根據今天上海的天氣，生成一段外灘街景影片",
  "duration": 5,
  "resolution": "720p",
  "tools": [{ "type": "web_search" }]
}

• tools 只支援 {"type": "web_search"}。
• 是否真正發起搜尋由模型依提示詞決定；只有實際發生搜尋時，才依搜尋次數額外計費（單價見控制台的價格說明），未搜尋則不額外收費。

取消任務

任務仍在排隊、尚未開始生成時，可以取消：

curl -X DELETE https://api.88api.ai/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-你的API金鑰"

• 取消成功會回傳 {"id": "task_xxx", "object": "video", "status": "cancelled", "cancelled": true}，任務隨後顯示為失敗（原因「任务已被用户取消」），不扣費。
• 已開始準備或生成、或已經結束的任務無法取消，會回傳 409 task_not_cancellable，請繼續查詢任務結果。
• DELETE /v1/video/generations/{id} 效果相同。

官方任務 ID

任務被火山方舟受理後，GET /v1/videos/{id} 會回傳 official_task_id（例如 cgt-20261012120000-abcde），控制台任務紀錄中也會顯示「官方任務 ID」。需要核對生成問題時，請同時提供任務 id 與官方任務 ID。任務仍在排隊、尚未被受理時不會回傳此欄位。

檔案上傳

可以用 multipart/form-data 直接上傳本機圖片，支援多張：以同一個欄位名稱（例如 image）重複上傳，依提交順序對應「圖片 1」「圖片 2」。上傳的圖片會自動放入虛擬人像庫並以入庫模式提交。

curl https://api.88api.ai/v1/videos \
  -H "Authorization: Bearer sk-你的API金鑰" \
  -F model=doubao-seedance-2.5 \
  -F "prompt=圖片 1 中的人物配戴圖片 2 的項鍊緩慢轉身" \
  -F duration=6 \
  -F resolution=720p \
  -F "image=@./model.png" \
  -F "image=@./necklace.png"

• 使用本機檔案時，不能再同時提交 images、image、input_reference 或 content 中的圖片。
• 單一檔案不超過 64 MB，整個請求不超過 128 MB。
• 本機影片與音訊不能用 multipart/form-data 直接上傳：請先依本機素材上傳取得 https:// URL，再填入參考影片或參考音訊欄位；參考音訊也可以使用 data: Data URI。