Seedance 2.5 API：呼叫方式、參數、限制與積分費用

直接回答：只要一把金鑰，就能透過 Yovid API 呼叫 Seedance 2.5。發送 POST https://yovid.ai/v1/videos/generations，帶上 "model": "seedance-2.5" 和提示詞，然後輪詢 GET /v1/tasks/{task_id}，直到狀態變成 completed，再讀取 output.video_url。片段長度為 4 到 30 秒，一次請求最多可帶 30 張圖片、10 段影片和 10 個音訊檔作為參考。計費使用和網站相同的 Yovid 積分，而且只有任務成功才會扣除積分。

目錄

1. Seedance 2.5 API 從哪裡取得
2. 四步驟快速上手
3. 請求參數
4. API 如何選擇生成模式
5. 參考素材與媒體限制
6. 一次請求的費用
7. 錯誤、重試與速率限制
8. 完整的 Python 範例
9. 常見問題

Seedance 2.5 API 從哪裡取得

Seedance 2.5 是 ByteDance Seed 的模型。ByteDance 自己的開發者管道是透過旗下的雲端平台：2026 年 7 月 31 日的發布文章表示，API 將透過 BytePlus ModelArk 開放；據媒體報導，Volcano Engine（火山引擎）於 8 月 7 日在中國開放 API；ByteDance 的 Seedance 2.5 頁面則連結到 BytePlus 的 playground。

Yovid 是獨立平台，與 ByteDance 沒有隸屬關係，透過自己的 API 提供 Seedance 2.5：

• 一把金鑰，一份帳單：同一把金鑰、同一份積分，涵蓋 Seedance 2.5、2.0、2.0 Fast、2.0 Mini、1.5 Pro 和 1.0 Pro Fast。
• 穩定的公開 ID：你送出的是 seedance-2.5；Yovid 把供應商的模型名稱留在內部，這些名稱變動時，你的程式碼也不會壞掉。
• 和網站同一個帳號：透過 API 生成的片段，使用的是你已有的方案和積分。

完整的參考文件在 Yovid API 文件；本指南聚焦在 Seedance 2.5 特有的部分。

四步驟快速上手

1. 建立 API 金鑰

打開設定 → API 金鑰，為金鑰命名並建立。完整的金鑰只會顯示一次，請存進機密管理工具，並在伺服器上以 YOVID_API_KEY 載入。絕對不要把它放進瀏覽器或行動裝置的程式碼裡。

2. 建立任務

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. 輪詢任務

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

狀態是 pending 或 processing 時，每 5 到 10 秒輪詢一次，並逐步拉長間隔。狀態變成 completed 時，影片網址就在 output.video_url；如果變成 failed，就停止輪詢並讀取 error。

4. 查詢積分

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available 是新任務可以使用的積分；reserved 是為仍在執行的任務預留的積分。

請求參數

API 會在建立任務前，依模型和你的方案檢查每個值；如果有不允許的值，會回傳 403 或 422，並在 param 中標出有問題的欄位。從某個影格開始生成時，輸出會沿用那張圖片的比例。

API 如何選擇生成模式

你不需要傳送供應商的模式。Yovid 會依你附上的媒體自動選擇：

在參考模式下，提示詞裡依檔案在各陣列中的順序指代它們：@image1、@image2、@video1、@audio1。參考請求看起來像這樣：

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

音訊參考是 API 專屬功能：網站的輸入框接受圖片和影片，API 則另外支援最多 10 個音訊檔，用來指定聲線、配樂或節奏。

參考素材與媒體限制

出自 API 文件的模型與輸入頁面：

所有媒體都必須是公開的 HTTPS 網址。Yovid 會拒絕 localhost、私有網路位址、內嵌帳密的網址，以及無法解析的主機名稱。請使用網址而不是 Base64；供應商把每個請求主體的上限設為 64 MB。

一次請求的費用

API 和網站使用同樣的積分、同樣的費率計費。以積分包標準價計算，Seedance 2.5 在 480p 每秒約 3 積分，720p 約 6.1 積分，所以 10 秒 720p 片段約 61 積分，30 秒則約 183 積分。訂閱用戶每秒費用更低。

• 參考影片：按參考片段長度加上輸出長度計費，費率較低：480p 每秒約 2.1 積分，720p 約 4.6 積分。
• 關閉 content_filter：費用乘以 1.1。
• 先預留，再扣除：建立任務時先預留積分，只有任務完成才會扣除；任務失敗會退回積分。
• 方案權限：Seedance 2.5 需要付費方案或一次性積分包。免費帳號會收到 403 plan_upgrade_required。

完成的任務會在 credits_used 中回報實際用量。方案和積分包見價格頁面，最便宜的入門方式見 Seedance 2.5 免費嗎。

錯誤、重試與速率限制

每把金鑰每分鐘最多 120 次請求，輪詢也算在內。建立任務的端點目前還不支援冪等鍵，所以在不確定第一次是否成功時，不要自動重試 POST：這可能會建立第二個任務、重複預留積分。請記下收到的每個 task_id。

完整的 Python 範例

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

這條提示詞用了時間段寫法，這是填滿 30 秒片段最可靠的方式。Seedance 2.5 提示詞指南裡有 13 條可以直接送出的提示詞，而和 Kling 3.0、Veo 3.1、Seedance 2.0 的比較，則能幫你決定要呼叫哪個模型 ID。

常見問題

Seedance 2.5 有官方 API 嗎？

ByteDance 透過旗下的雲端平台 Volcano Engine（火山引擎）和 BytePlus，向開發者提供 Seedance 2.5。Yovid 的 API 是獨立的替代方案：一把金鑰、一份積分餘額，就能使用 Seedance 2.5 和其他 Seedance 模型。

Yovid 上 Seedance 2.5 的模型 ID 是什麼？

seedance-2.5。其他公開 ID 有 seedance-2.0、seedance-2.0-fast、seedance-2.0-mini、seedance-1.5-pro 和 seedance-1.0-pro-fast。

Seedance 2.5 API 生成的影片最長多長？

每個任務 4 到 30 秒，用 duration 設定。

Seedance 2.5 API 支援哪些解析度？

API 文件列出 seedance-2.5 支援 480p 和 720p。你的方案也會設定上限，如果畫質超過上限，API 會在建立任務前回傳 403。

可以用音訊當參考嗎？

可以，在 audio_urls 中最多放 10 個 MP3 或 WAV 檔，提示詞裡依序以 @audio1、@audio2 等指代。音訊參考只能透過 API 使用。

失敗的任務會扣積分嗎？

不會。建立任務時會先預留積分，只有任務成功完成才會扣除。

我可以發送多少請求？

每把金鑰每分鐘最多 120 次請求（含輪詢），另外還有依方案而定的同時執行任務上限。收到 429 回應，代表要先等一下，再以逐步拉長的間隔重試。

準備好開始開發了嗎？在設定 → API 金鑰建立金鑰，然後照著 API 快速上手操作。