<!-- Canonical URL: https://ask.atlascloud.ai/zh-TW/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Seedance 2.5 API 快速入門：使用 Atlas Cloud 生成您的第一個影片

> 今天就在 Atlas Cloud 上使用一個 API 金鑰和兩個 REST 呼叫，發布一個可運作的 Seedance 影片整合，然後在 Seedance 2.5 推出時，透過更改一個模型字串來替換。

您閱讀了 [Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 的公告，您圍繞 30 秒生成的剪輯設計了一個產品功能，現在您想編寫程式碼。然後您遇到了每個開發人員在剛發布的模型上都會遇到的問題：功能頁面已上線，但您實際上可以從應用程式呼叫的端點卻是完全不同的問題。

這是情況的真實版本，以及一個尊重它的快速入門。Atlas Cloud 已發布一個 [Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5 系列頁面，承諾在已經服務 [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 和 1.5 的統一端點上提供 Day-0 存取。在撰寫本文時，該列表標記為「即將推出」，並且尚未發布 Seedance 2.5 的 Atlas Cloud 價格。這實際上意味著好消息：您今天針對實時 Seedance 層級構建的整合，與您在 2.5 推出時運行的整合是相同的。唯一改變的是模型字串。

因此，這個快速入門有兩個作用。它今天從真實端點獲取真實影片，並組織您的程式碼和提示，以便升級只需一行差異。

## Seedance 2.5 實際發布了什麼

根據 ByteDance 官方的 Seedance 2.5 頁面，這是一個下一代音訊-影片聯合生成模型，專為 30 秒的敘事而構建，具有精確的參考控制和強大的編輯功能。值得設計的具體聲明：

* 單次生成最長 30 秒，可選擇延長兩次以進行更長、更完整的敘事
* 更流暢、更一致的動作，具有更逼真的視覺效果
* 更精確的參考影片理解，捕捉意圖、構圖和電影語言，而不僅僅是傳輸動作
* 在更廣泛的音訊和視覺編輯請求中提供更可靠的編輯
* 白模型控制和綠幕編輯，以及專業的攝影機運動和表演阻擋，旨在應對複雜的製作流程

請注意列表中沒有的內容：沒有基準表，沒有解析度階梯，沒有參考資產計數。您看到的任何類似內容都是某人的行銷潤飾，而不是第一方規格表。根據上述聲明進行構建。

## 步驟 1：從控制台獲取金鑰

登入 console.atlascloud.ai 並建立一個 API 金鑰。沒有押金，沒有最低承諾，也沒有等候名單，因此金鑰可以立即按用量付費使用。一個金鑰涵蓋了文字、圖像和影片的 300 多個模型的完整目錄，在一個計費帳戶下，這是此快速入門的關鍵部分：您現在鑄造的金鑰將呼叫 Seedance 2.5。

將其儲存為環境變數，切勿儲存在原始碼中。`ATLASCLOUD_API_KEY` 是一個不錯的名稱。

## 步驟 2：提交影片任務

Atlas Cloud 上的影片生成是一個兩步非同步 REST 呼叫，而不是聊天完成。您 POST 一個任務並獲得一個預測 ID，然後您輪詢該 ID 直到渲染完成。任何 HTTP 用戶端都可以，因此無需安裝供應商 SDK，也無需學習新的身份驗證方案：它是您剛鑄造的金鑰上的 bearer token。

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

回應為 `{"code": 200, "data": {"id": "...", "status": "processing"}}`。請注意，`model` 是一個純字串欄位。這個細節是本文的整個升級故事，步驟 6 將會回顧它。

## 步驟 3：輪詢直到渲染完成

5 秒的剪輯不是即時回應，因此將渲染視為具有生命週期的任務，而不是阻塞呼叫。輪詢預測端點直到 `status` 達到終端值。

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # on success the payload carries the output URL(s)
```

有兩件事值得現在就構建，而不是以後。為輪詢循環設定上限，這樣卡住的任務就不會掛起請求處理程式，並在開始輪詢之前持久化預測 ID，這樣崩潰的工作程式就可以恢復，而不是支付兩次渲染費用。這兩種習慣都將不變地延續到 2.5。

如果您的功能是從參考圖像或主題參考而不是純文字開始的，則相同的流程適用於不同的模型變體，`bytedance/seedance-2.0/image-to-video` 或 `bytedance/seedance-2.0/reference-to-video`。主題參考資產透過 `uploadMedia` 上傳一次，然後在圖像欄位中作為 `asset://<id>` 傳遞，因此重複出現的角色或產品無需在每次呼叫時重新上傳。

## 步驟 4：選擇一個實時 Seedance 層級並了解每秒的成本

Atlas Cloud 根據輸出持續時間的每秒計費影片。這是您在編寫任何程式碼之前可以在腦海中完成的算術。目前有三個 Seedance 層級：

| 模型 | 模型 ID | Atlas Cloud 價格 | 值得注意 |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0.112/s | 旗艦實時層級，即時金鑰，無等候名單 |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0.09/s | 同系列的更快變體 |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0.056/s | 最便宜的實時 Seedance 2.0 層級，也支援圖像轉影片和參考轉影片 |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0.047/s，或 Fast 變體為 $0.018/s | 原生同步音訊，多語言唇形同步，4 到 12 秒的剪輯 |

為了方便理解，同一金鑰上的其他影片模型運行在可比較的範圍內：Grok Imagine Video v1.5 為 $0.080/s，[Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 為 $0.100/s，[Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo 標準為 $0.112，折扣後為 $0.095，MiniMax H3 為 $0.14/s。

選擇哪個構建取決於您的 2.5 功能最終將做什麼。如果音訊是輸出的核心，Seedance 1.5 Pro 是已經具有原生同步音訊和多語言唇形同步的層級，因此您的管道從第一天起就學會處理音軌。如果您正在迭代提示結構並希望每次實驗的成本最低，Seedance 2.0 Mini 以 $0.056/s 的價格是顯而易見的沙盒。如果您想要最接近生產級別的當前生成渲染，Seedance 2.0 以 $0.112/s 的價格是直接的選擇，如果吞吐量比最後的品質增量更重要，則 Fast 變體為 $0.09/s。

## 步驟 5：在花費之前在 Playground 中檢查實時價格

在您第一次付費呼叫之前，請在 Atlas Cloud Playground 中打開模型。每個模型都會在「運行」按鈕旁邊顯示其實時的每模型價格。這比聽起來更重要：促銷折扣來來去去，而「運行」按鈕旁邊的數字才是實際計費的數字。在 Playground 中運行一次生成，確認輸出是您的功能所需的，然後將設定移植到程式碼中。

按輸出秒數計費的模型也使您的預算對話變得微不足道。Seedance 2.0 Mini 上的 10 秒剪輯是 10 × $0.056。沒有計算器，沒有 token 估計，也沒有事後核對步驟。

這與第一方 ByteDance 頻道如何計費 Seedance 形成對比。在中國的 Volcano Engine Ark 和國際上的 BytePlus ModelArk 上，計費是基於 token 的：估計的 token 消耗是 (輸入影片持續時間 + 輸出影片持續時間) × 輸出寬度 × 輸出高度 × 輸出幀率 / 1024，乘以 token 單價，實際使用量以 API 回應中 `usage.completion_tokens` 欄位為準。對於 Seedance 2.0 系列和 Seedance 2.5，當輸入包含影片時，適用最低 token 消耗下限，下限取決於解析度、長寬比和輸出持續時間。ByteDance 發布了定價計算器和最低 token 表正是出於這個原因。

兩種模型都是合法的。但是，如果您正在預算 30 秒的渲染，按輸出秒數計費是心算，而帶下限的 token 則需要電子表格。

## 步驟 6：像已經是 2.5 一樣編寫鏡頭描述

這是快速入門中完美轉移的部分，因為提示技巧沒有版本控制。2.5 的兩個功能聲明應該改變您今天的寫作方式。

**精確的參考控制。** ByteDance 聲稱 2.5 讀取參考影片的意圖、構圖和電影語言，超越了動作傳輸。提示的含義是您的參考資產不再是動作模板，而是導演簡報。因此，停止編寫僅描述主題的提示，並開始命名您希望傳達的語法：鏡頭感、構圖、剪輯節奏、攝影機是引導還是跟隨主題。寫「手持、跟隨主體的中景鏡頭，穿梭於夜市的快遞員，濕瀝瀝的柏油路上霓虹燈反射，轉彎時略有延遲」而不是「走路的人，電影感」。

**單次生成 30 秒。** 5 秒的剪輯是一個鏡頭。30 秒是一個有結構的場景，2.5 支援在此基礎上延長兩次。因此，編寫帶有節奏結構的鏡頭描述，而不是單一的靜態描述：一個建立節奏、一個變化（轉彎、進入、揭示）和一個解決方案。明確命名攝影機運動和表演阻擋，因為這些正是 2.5 旨在實現的控制。主體站在哪裡，他們如何移動，攝影機在他們移動時做什麼。

這兩種習慣現在都在實時層級上得到了回報。這兩種習慣正是 2.5 所獎勵的。

## 步驟 7：規劃交換

組織您的程式碼，使模型識別符是配置，而不是文字。一個常數，從環境或配置中讀取：

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

然後將 `SEEDANCE_MODEL` 傳遞給步驟 2 中硬編碼字串的地方。因為 `model` 是 `generateVideo` 主體中的單個 JSON 字串欄位，所以 2.5 推出時的升級確實是一個環境變數。這不是一個小變化的比喻，而是字面上的一個值。

今天切勿硬編碼 Seedance 2.5 識別符，因為 Atlas Cloud Seedance 2.5 模型 ID 尚不存在。從 atlascloud.ai/models 的目錄中獲取確切的實時 ID，而不是從文章（包括本文）中複製它們，因為新變體會隨著時間的推移而添加。當 2.5 在 Day-0 承諾下發布時，您這邊的工作就是那個變數，加上重新查看「運行」按鈕旁邊的價格，並重新閱讀任何新的請求參數，因為支援擴展的 30 秒模型可能會接受 2.0 主體沒有的欄位。

同時，如果您今天需要 Seedance 2.5 而不是在 Atlas Cloud 推出時，誠實的答案是第一方 ByteDance 頻道：中國的 Volcano Engine Ark 和國際上的 BytePlus ModelArk。在聚合器中，有幾個處於相同的預發布或 Day-0 承諾狀態。

## 常見問題

問：我現在可以在 Atlas Cloud 上呼叫 Seedance 2.5 嗎？
答：不能。Atlas Cloud 上的 Seedance 2.5 系列頁面標記為「即將推出」，並承諾在已經服務 Seedance 2.0 和 1.5 的統一端點上提供 Day-0 存取。目前尚未發布其模型 ID 和價格。

問：Seedance 在 Atlas Cloud 上今天的費用是多少？
答：Seedance 2.0 為 $0.112/s，Seedance 2.0 Fast 為 $0.09/s，Seedance 2.0 Mini 為 $0.056/s，Seedance 1.5 Pro 為 $0.047/s 或其 Fast 變體為 $0.018/s。計費是按輸出持續時間的每秒計算，實時價格顯示在 Playground 中「運行」按鈕旁邊。

問：我需要特殊的 SDK 才能在 Atlas Cloud 上使用影片嗎？
答：不需要。影片是一個純粹的 REST 流程：`POST /api/v1/model/generateVideo` 提交任務，然後 `GET /api/v1/model/prediction/{id}` 輪詢它，兩者都使用您的 Atlas Cloud 金鑰上的 bearer token 進行身份驗證。任何 HTTP 用戶端都可以。請注意，影片不通過文字目錄使用的 OpenAI 相容聊天端點，因此不要期望 `chat.completions` 渲染剪輯。每個模型的請求參數都記錄在 atlascloud.ai/docs 上。

問：開始使用需要押金或最低承諾嗎？
答：不需要。Atlas Cloud 是按用量付費，沒有押金，沒有最低承諾，也沒有等候名單，並且來自 console.atlascloud.ai 的金鑰可以立即使用。

問：如果我以 2.5 為目標，我應該在哪個實時層級上進行原型設計？
答：Seedance 2.0 Mini 以 $0.056/s 的價格用於廉價提示迭代，如果您的管道需要處理原生同步音軌，則選擇 Seedance 1.5 Pro，如果需要最接近當前生成生產渲染，則選擇 Seedance 2.0 以 $0.112/s 的價格。

## 總結

Atlas Cloud 今天運行 Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini 和 Seedance 1.5 Pro，使用一個 API 金鑰，按輸出持續時間每秒計費，具有 SOC II 認證、HIPAA 合規性以及靜態和傳輸中的加密，並且已發布 Day-0 承諾，在 Seedance 2.5 發布時在這些相同的統一端點上提供服務。

如需相關實作指引，請參閱[現已推出最新的影像、影片和LLM API](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now)以及[估算AI推論容量、延遲和成本](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost)。