Source: https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0/
Canonical: https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0/
Language: zh-hant-tw

# ByteDance: Seedance 2.0

[Markdown](https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0/facts.json)

## [ByteDance: Seedance 2.0](https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0/)

ByteDance Seedance 2.0 結合原生音訊與影片生成，以及圖片、影片與聲音參考。可導演新場景、編輯既有影片或延伸序列；標準版包含文件記載的 1080p 與 10 位元 4K 輸出。

- [**Ailoot Ultra · 影片** `POST /v1/videos` `bytedance/seedance-2.0`](https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0/#method-0)

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

Seedance 2.0 是 ByteDance Seed 用於多模態視聽創作的標準模型。它在聯合生成架構中結合文字、圖片、影片與音訊，並為參考導向場景、影片編輯及影片延伸提供不同創作工作流程。若需求同時需要連貫表演，以及準備素材中的特定視覺或聲音資訊，這很實用。

#### 多模態參考與導演控制

圖片可定義主體外觀、視覺風格及構圖。影片參考可引導動作、鏡頭運動與效果；音訊可引導音色、音樂或對話。請先定義各素材角色，再描述應形成的場景。製造商強調對表演、照明、陰影及鏡頭語言的控制。

產品故事可準備產品圖片、鏡頭運動參考及音訊提示。例如：「保留 Image 1 的藍色玻璃花瓶。使用 Video 1 的緩慢橫移鏡頭。花瓶放在陽光照射的層架，搭配以 Audio 1 為基礎的柔和器樂。」預定輸出是組合所選參考資訊、重新調度的新場景。

參考輸入可結合圖片加音訊、圖片加影片、影片加音訊，或三者一起。不支援僅有音訊，或沒有圖片或影片的文字加音訊。文件也記載傳統文字轉影片、首幀生成及首尾幀生成。若固定開場與結尾構圖重要，請使用專用終點工作流程：在 omni-reference 提示中將參考圖片稱為終點，只是間接引導。

#### 編輯影片

模型可替換主體、新增或移除物體、變更元素，並重繪或修復影片部分內容。請描述具體變更並識別來源影片。新增時應包含出現時間與位置；移除或替換時應精確指出物體，並說明應保留什麼。

例如：「將 Video 1 的檯燈替換為 Image 1 的黃銅燈。保留鏡頭運動、桌面配置與光線方向。」預定結果是施作指定替換的場景編輯版。請同時檢查未變更區域與新物體，尤其是經過遮擋、移動及切鏡時。

#### 延伸與連接序列

Seedance 2.0 可延長影片後續或補足前段，並透過生成轉場連接最多三段輸入影片。請指定時間方向與新事件。銜接時應排列片段，並描述每對片段之間的轉換，例如一個鏡頭的攝影機進入門口，再抵達下一個環境。

直接的延伸通常傳回從來源影片周圍發展的延續；若最終結果也應重複原區段，請加入明確指示。完成兩段或三段影片間的銜接時，文件所述工作流程可包含原始素材與新轉場內容。這適合發展開場或結尾，或在不留下未指定銜接動作的情況下連接準備好的場景。

#### 標準版輸出與 4K

標準版記載每秒 24 幀的 MP4，以及 4 至 15 秒時長。輸出等級為 8 位元色深的 480p、720p 與 1080p，另有 10 位元色深的 4K。支援比例是 21:9、16:9、4:3、1:1、3:4 及 9:16。文件也記載自適應取景與自動時長選擇。Fast 版本有自己較窄的 480p／720p 輸出規格。

4K 輸出使用 H.265/HEVC 編碼。10 位元編碼保留更多明暗層次與更平滑的色彩轉換，對細緻光線或色彩漸層素材很重要。請確認預定播放與編輯環境可解碼該格式；部分瀏覽器及裝置無法直接播放。容器相容本身不保證影片解碼相容。

模型可生成同步聲音或無聲影片，也可傳回最後生成畫面供下一場景使用。生成音訊為單聲道。2.0 系列不支援獨立的兩階段 Draft 預覽模式，不能從其他 Seedance 版本推定它有該預覽功能。

#### 參考準備與實質上限

文件記載的參考容量最多為九張圖片、三段影片及三段音訊。此製作者規格不接受含真實人臉的參考圖片或影片直接上傳；人像工作使用其支援的人像素材工作流程。每段影片及音訊必須為 2 至 15 秒。所有影片參考合計須在 15 秒內，所有音訊參考則另有 15 秒總長。影片使用 MP4 或 MOV、每秒 24 至 60 幀，每段最多 200 MB；音訊使用 WAV 或 MP3，每段最多 15 MB。圖片格式列有 JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC 及 HEIF。每張圖片必須小於 30 MB，請求本文不得超過 64 MB。文件所述參考輸入規格中，圖片寬與高皆須大於 300 且小於 6,000 像素，寬高比須大於 0.4 且小於 2.5。參考影片各邊可為 300 至 6,000 像素、比例為 0.4 至 2.5，包含端點，總像素數為 407,696 至 8,295,044。MP4 或 MOV 影片使用 H.264/AVC 或 H.265/HEVC 影像，以及 AAC 或 MP3 音訊。

請有意識地排列檔案，並以媒體類型與編號參照各素材：Image 1、Video 1 及 Audio 1。編號依該類型內的檔案順序決定。請解釋應轉移哪些特質，以及哪些來源內容不應定義新場景。文件列出的提示語言包括英語、西班牙語、印尼語、葡萄牙語及日語。請在對話中保持口述語言一致；指南建議除專有名詞外避免混用語言。聲音引導工作應分開指定說話者、確切台詞及表達方向。

首尾圖片應準備相容取景。輸入圖片與輸出尺寸不一致，可能造成裁切或突兀的視覺變化；尺寸一致與自適應取景是文件列出的解法。請將描述集中於事件與參考角色。製造商提醒，長提示可能分散資訊，使細節被忽略。請將生成動作、參考連貫性、音訊表演及場景接縫，視為創作成果的不同部分來檢查。

#### 鏡頭規劃與文字指示

複雜場景應將需求整理成 Shot 1、Shot 2 及 Shot 3，依序指定攝影機、主體動作、位置與聲音。指南建議每個鏡頭安排一個鏡頭運動，並優先採用緩慢、連貫的動作。精確逐鏡時間戳記不穩定，因此事件序列是比強制數個精準時間窗更好的控制方式。

模型也可生成標語、字幕及對話泡泡等常見文字。可指定文字色彩、視覺處理、位置與進場。請使用常用字而非罕用字或特殊符號，並在移動中檢查措辭。主體參考應將每份素材明確綁定至預定角色或物體。產品視角可提供不同視覺資訊；角色多面轉身拼圖則可能混淆臉部身分。使用分開且清楚的頭像與全身圖片，是文件記載的角色參考建議。

#### 編輯前應檢查的行為

指南記載不需要的字幕、標誌、重複角色及風格漂移。乾淨來源素材、一致標籤及明確限制可降低這些風險，但不保證不需要的文字或重複人物消失。超過四位參考人物被報告為穩定性風險，與模型接受的檔案數不同。

影片延伸可能在接縫跳動或倒退，反覆延續也可能累積畫質下降。請檢查邊界畫面並限制堆疊延伸。參考聲音可能不同於來源音色；旁白可能以喀聲或突然截斷結束，音訊淡出是文件記載的解法。中文多音字、罕用字或形近字可能讀錯。若需要倒數等精確動畫效果，動作參考比純口頭要求提供更多資訊。這些都是選擇片段時，應分開檢查身分、文字、動作與聲音的具體原因。

**Ailoot Ultra · 影片** `POST /v1/videos` `bytedance/seedance-2.0`

[`bytedance/seedance-2.0`](https://ailoot.ai/models/zh-hant-tw/#m=bytedance%2Fseedance-2.0&route=Ultra&caller=bytedance%2Fseedance-2.0&fmt=videos)

ByteDance /`bytedance/seedance-2.0`

### 入門

ByteDance Seedance 2.0 結合原生音訊與影片生成，以及圖片、影片與聲音參考。可導演新場景、編輯既有影片或延伸序列；標準版包含文件記載的 1080p 與 10 位元 4K 輸出。

接受的輸入

文字 · 圖片 · 音訊

結果

影片

### Ailoot 可用 · 輸入與方法

**Ailoot Ultra · 影片** `POST /v1/videos`

輸入

`text`, `image`, `audio`

輸出

`video`

輸出格式

原始 MP4 位元組；不進行正規化或轉碼

| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
| --- | --- | --- | --- | --- |
| 欄位`model` | 類型`string` | 要求必填 | 值與限制 bytedance/seedance-2.0 | 預設值— |
| 欄位`prompt` | 類型`string` | 要求必填 | 值與限制 | 預設值— |
| 欄位`duration` | 類型`integer` | 要求必填 | 值與限制 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 最小值: 1 最大值: 600 | 預設值— |
| 欄位`resolution` | 類型`string` | 要求選填 | 值與限制 480p, 720p, 1080p, 4K | 預設值— |
| 欄位`aspect_ratio` | 類型`string` | 要求選填 | 值與限制 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | 預設值— |
| 欄位`generate_audio` | 類型`boolean` | 要求選填 | 值與限制 false, true 條件: 在 480p 與 720p 下，省略 generate\_audio 會選用含音訊的價格，設為 false 則會選用不含音訊的價格。在 1080p 與 4K 下，兩種設定均適用該解析度的價格。請查看結果中的 has\_audio，確認回傳的音軌。 | 預設值— |
| 欄位`frame_images` | 類型`array` | 要求選填 | 值與限制 項目數下限: 1 項目數上限: 2 輸入內容: 影格物件陣列。每個物件包含 type=image\_url、內含 url 的 image\_url，以及 frame\_type=first\_frame 或 last\_frame。每種角色最多只能出現一次。請使用公開的 HTTPS URL。 確切鍵名: type, image\_url, frame\_type 條件: 這些鍵適用於每個影格物件。僅含文字的請求請省略 frame\_images。 | 預設值— |
| 欄位`input_references` | 類型`array` | 要求選填 | 值與限制 輸入內容: 圖片或音訊參考物件的陣列。請將 type 設為 image\_url 或 audio\_url，並提供相應且內含 url 的 URL 物件。影片參考資料仍無法定價。 條件: 省略 frame\_images 即可使用參考資料模式。請使用公開的 HTTPS URL。 | 預設值— |
| 欄位`size` | 類型`string` | 要求選填 | 值與限制 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 模式: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ | 預設值— |
| 欄位`seed` | 類型`integer` | 要求選填 | 值與限制 最小值: -9,223,372,036,854,775,808 最大值: 9,223,372,036,854,775,807 | 預設值— |
| 欄位`callback_url` | 類型`string` | 要求選填 | 值與限制 模式: ^https:// | 預設值— |
| 欄位`session_id` | 類型`string` | 要求選填 | 值與限制 | 預設值— |
| 欄位`trace` | 類型`object` | 要求選填 | 值與限制 | 預設值— |
| 欄位`user` | 類型`string` | 要求選填 | 值與限制 | 預設值— |

輸入素材組合

**文字生成影片** · 文字提示詞。 · 必填： model, prompt, duration

`請提供文字提示詞與支援的整數秒長度。請使用列出的確切大小，或可對應至列出尺寸的解析度與長寬比。`

`model`: 類型： string · bytedance/seedance-2.0

`prompt`: 類型： string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是

**圖片生成影片** · 文字提示詞與影格圖片。 · 必填： model, prompt, duration, frame\_images

`frame_images 是物件陣列，每個物件包含 type=image_url、內含 url 的 image_url，以及 frame_type。請使用公開的 HTTPS 圖片 URL；first_frame 與 last_frame 各最多只能出現一次。請使用列出的輸出大小或相容尺寸。切勿加入影片參考資料。`

確切鍵名： type, image\_url, frame\_type

`model`: 類型： string · bytedance/seedance-2.0

`prompt`: 類型： string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是

**Reference to video** · 文字提示詞與圖片或音訊參考資料。 · 必填： model, prompt, duration, input\_references

`input_references 是陣列。每個物件包含 type=image_url 或 type=audio_url，以及相應且內含 url 的 URL 物件。請使用公開的 HTTPS 連結。省略 frame_images 即可選擇參考資料模式。影片參考資料無法定價。`

`model`: 類型： string · bytedance/seedance-2.0

`prompt`: 類型： string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是

方法參數與生命週期

| 參數 | 規格 |
| --- | --- |
| 參數`content_type` | 規格application/json |
| 參數`required` | 規格model, prompt, duration |
| 參數`material_types` | 規格text, image, audio |
| 參數`additional_properties` | 規格false |
| 參數`optional_controls` | 規格resolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, size, seed, callback\_url, session\_id, trace, user |

生命週期： `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### 方案

##### 最終費用的計算方式

顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。

費率資訊不會增加請求選項。支援的參數列於所選方法中。

快速模式

未指定 選取快速模式時

flex 模式

未指定 選取 flex 模式時

最高推理強度

未指定 最高推理強度採用 default 調整值時

#### 供比較的預估費率

#### 各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

| 設定 | 費率表 | 預估數量 | 計費單位 | 計費條件 | 費用 |
| --- | --- | --- | --- | --- | --- |
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 計費單位— | 計費條件— | 費用 輸入 · 輸入 Token · 僅供比較的估算 **—** / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 **—** / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 **—** / 1K Token |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片詞元價格 · 僅供比較的估算 **$0.014** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件resolution: 1080p | 費用 輸出 · 影片詞元價格 · 僅供比較的估算 **$0.0154** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件輸入：with\_video\_input；解析度：1080p | 費用 reference · 影片詞元價格 · 僅供比較的估算 **$0.0094** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件resolution: 4k | 費用 輸出 · 影片詞元價格 · 僅供比較的估算 **$0.008** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件輸入：with\_video\_input；解析度：4k | 費用 reference · 影片詞元價格 · 僅供比較的估算 **$0.0048** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件輸入：with\_video\_input | 費用 reference · 影片詞元價格 · 僅供比較的估算 **$0.0086** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 費率表— | 預估數量— | 計費單位per 1,000 video tokens | 計費條件音訊：without\_audio | 費用 輸出 · 影片詞元價格 · 僅供比較的估算 **$0.014** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 計費單位— | 計費條件— | 費用 輸出 · 預估生成費用 · 僅供比較的估算 **$0.3024** 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 |

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/)

#### 參考費率詳情

模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。

影片設定的價格參考

#### 各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

| 設定 | 計費條件 | 費用 |
| --- | --- | --- |
| 設定影片詞元價格 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片詞元價格 **$0.014** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 計費條件resolution: 4k | 費用 輸出 · 影片詞元價格 **$0.008** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 計費條件resolution: 1080p | 費用 輸出 · 影片詞元價格 **$0.0154** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 計費條件音訊：without\_audio | 費用 輸出 · 影片詞元價格 **$0.014** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 計費條件輸入：with\_video\_input | 費用 reference · 影片詞元價格 **$0.0086** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 計費條件輸入：with\_video\_input；解析度：4k | 費用 reference · 影片詞元價格 **$0.0048** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |
| 設定影片詞元價格 | 計費條件輸入：with\_video\_input；解析度：1080p | 費用 reference · 影片詞元價格 **$0.0094** 每 1K 影片 Token 影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。 |

### 請求範例

#### Ailoot Ultra · 影片

curl · 建立影片

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### 接收並儲存結果

#### Ailoot Ultra · 影片

自有內容的簽署 URL

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### 查看工作狀態

GET · 取得原始作業狀態

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

其他內容讀取方式

儲存所有已完成且屬於自己的輸出

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### 保留所有已完成的結果

請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。

請保留每個實際的自有輸出，以及回傳的實測中繼資料。

##### 需要檢查原始回應時

503 result\_pending\_check + 原始 id + X-Should-Retry:false；切勿重送原始請求

回應欄位

| 欄位 | 類型 | 含義 |
| --- | --- | --- |
| 欄位`index` | 類型integer | 含義此影片在輸出清單中的位置，索引從零開始。 |
| 欄位`content_url` | 類型string | 含義此已完成影片的簽署 HTTPS 下載 URL。 |
| 欄位`sha256` | 類型string \| null | 含義原始影片位元組的 SHA-256 摘要；無法取得時為 null。 |
| 欄位`size_bytes` | 類型integer \| null | 含義原始影片檔案大小，以位元組為單位；無法取得時為 null。 |
| 欄位`duration_ms` | 類型integer \| null | 含義實測的影片長度，以毫秒為單位；無法取得時為 null。 |
| 欄位`width` | 類型integer \| null | 含義影片寬度，以像素為單位；無法取得時為 null。 |
| 欄位`height` | 類型integer \| null | 含義影片高度，以像素為單位；無法取得時為 null。 |
| 欄位`video_codec` | 類型string \| null | 含義影片編碼識別碼；未記錄時為 null。 |
| 欄位`has_audio` | 類型boolean \| null | 含義影片是否包含音軌；未測量時為 null。 |
| 欄位`audio_codec` | 類型string \| null | 含義音訊編碼識別碼；未記錄識別碼時為 null。 |

錯誤與後續步驟

| 回應 | 條件 | 下一步 |
| --- | --- | --- |
| 回應404 · `not_found_error` | 條件無法存取影片，或找不到此影片 ID。 | 下一步請確認影片存取權限。若影片已存在，請使用其原始公開 ID 與相同的 API 金鑰。 |
| 回應401 · `authentication_error` | 條件API 金鑰與已驗證的帳號不符。 | 下一步提交前，請先確認 API 金鑰與帳號存取權限。 |
| 回應400 · `invalid_request_error` | 條件無法讀取請求，或下載索引無效。 | 下一步請修正請求本文。若要下載，請選擇原始工作回傳的輸出索引。 |
| 回應422 · `price_unavailable` | 條件所選影片設定無法定價。 | 下一步請選擇支援的影片設定，填妥其必要選項，再提交修正後的請求。 |
| 回應422 · `invalid_request_error` | 條件影片輸入或原始延續工作無效。 | 下一步請使用有效的 HTTPS 輸入。若要延續影片，請使用已完成原始影片的公開影片 ID，以及相同的 API 金鑰。 |
| 回應402 · `billing_error` | 條件可用餘額或限制不允許預留額度。 | 下一步傳送新的請求前，請先確認可用餘額與限制。 |
| 回應503 · `server_error` | 條件影片驗證、儲存系統或服務存取暫時無法使用。 | 下一步請等待服務恢復可用。若已有影片 ID，請查詢該原始工作，切勿另行建立生成工作。 |
| 回應503 · `result_pending_check` | 條件原始影片結果與費用需要查核。 | 下一步請保留回傳的影片 ID，並查詢該工作。查詢期間切勿傳送替代的生成請求。 |
| 回應503 · `owned_result_unavailable` | 條件現有影片暫時無法下載。 | 下一步請稍後查詢同一影片工作，並下載其現有輸出。新的生成請求會建立獨立操作。 |
| 回應409 · `video_not_ready` | 條件影片內容尚未發布。 | 下一步請查詢原始工作狀態。回報 completed 後再下載；若回報 failed，請依其費用查核通知處理。 |

### 別名

#### 模型別名

**Ailoot Ultra** [`bytedance/seedance-2.0`](https://ailoot.ai/models/zh-hant-tw/#m=bytedance%2Fseedance-2.0&route=Ultra&caller=bytedance%2Fseedance-2.0&fmt=videos)

#### 方法路徑別名

請使用上方列出的 API 方法路徑。

#### 相關呼叫用 ID

[`bytedance/seedance-2.0`](https://ailoot.ai/models/zh-hant-tw/#m=bytedance%2Fseedance-2.0&route=Ultra&caller=bytedance%2Fseedance-2.0&fmt=videos)

FAQ · ByteDance: Seedance 2.0

可以使用哪些輸入與結果？

`POST /v1/videos` · `bytedance/seedance-2.0`: `text`, `image`, `audio` → `video`

請求使用哪些欄位？

`POST /v1/videos` · `bytedance/seedance-2.0`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `size`, `seed`, `callback_url`, `session_id`, `trace`, `user`

適用哪些限制？

`POST /v1/videos` · `bytedance/seedance-2.0`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。

## 公司及其專案組合

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

## 優惠購買 token。

訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。

訂閱

為定期請求選擇優惠方案。

最高 50% 折扣碼

購買時輸入代碼，價格依活動重算。

歷史中的費用

每次請求保存模型、token 與金額。

[選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/)

## 將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。

商用應用程式

在付費功能加入文字、圖片、影片與聲音生成。

經銷授權

提供專案說明與存取方式，要求書面使用和轉售條件。

網站文件

串接前可閱讀正式服務條款、授權合約與資料處理政策。

[申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw)

## Ailoot · 公司及其專案組合





Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。





公司及其專案組合：數百萬客戶，每月銷售額達數十億。





Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。