{ "aboutHtml": "

Seedance 2.0 Fast 是 ByteDance Seed 在 Seedance 2.0 系列中以速度為導向的版本。它支援影片與音訊聯合生成，以及由文字、圖片、影片及聲音構成的多模態需求說明。創作能力包括參考導向的新場景、既有影片編輯及場景延伸，文件所述輸出等級為 480p 與 720p。

多模態參考：為素材分配角色

圖片可提供角色、產品、構圖或視覺處理。參考影片可提供動作、鏡頭運動或效果。參考音訊可提供音色、音樂旋律或對話內容。請解釋每份來源的哪個部分要帶入新場景；具備明確創作角色的參考更實用。

例如：「以 Image 1 的陶瓷燈作為產品。跟隨 Video 1 的緩慢環繞鏡頭，但將燈放在安靜的閱讀角落。以 Audio 1 指定音樂情緒。」預定輸出是結合所選外觀、動作及聲音方向的新場景，而非未加指定地模仿參考中的每項細節。

文件記載的組合包括圖片加音訊、圖片加影片、影片加音訊，以及三者一起使用。不支援僅有文字加音訊，或僅有音訊的輸入。模型也支援文字轉影片，以及以首幀或首尾幀配對進行圖片主導生成。若精確終點是需求核心，請使用專用終點工作流程；在 omni-reference 提示中將參考圖片描述為終點，是間接控制。

編輯既有影片

模型可新增、移除或修改元素，替換主體，並重繪或修復場景部分內容。請識別來源影片、要改變的物體及應維持的元素。新增時應描述出現位置與時間；移除時應在整段影片中一致識別該物體。

實用編輯需求可將示範中的素面瓶子，替換為 Image 1 的瓶子，同時要求保留 Video 1 的手部動作、背景及攝影機路徑。請同時檢查替換內容與應保持穩定的區域。明確的保留指示，比泛泛要求「改善」影片更容易評估預定編輯。

延伸與連接片段

Seedance 2.0 Fast 支援向後續接或向前補足，並以生成轉場連接兩段或三段影片。延伸時，請指出新動作發生在輸入影片之前或之後，再描述該動作。連接時則依預定順序提供片段，並說明銜接它們的視覺事件。

簡單延伸通常傳回在原影片周圍新發展的延續部分，而非假設整段來源片段會重複。若輸出應包含原區段，請在需求中明說。填補兩段或三段影片間的轉場時，文件所述工作流程可組合原始與新生成內容。這適合透過有目的的鏡頭運動，將產品全景連至細節鏡頭。

輸出與版本差異

文件所述 Fast 輸出為每秒 24 幀的 MP4、480p 或 720p、8 位元色深，以及 4 至 15 秒片段。支援比例為 21:9、16:9、4:3、1:1、3:4 及 9:16。標準 Seedance 2.0 版本另列 1080p 與 4K 輸出，這些等級不屬於 Fast 規格。2.0 系列支援傳回最後生成畫面，但不支援獨立的 Draft 預覽模式。

音訊可隨影片生成，也可省略以製作無聲片段。生成音訊為單聲道。文件列出的提示語言包括英語、西班牙語、印尼語、葡萄牙語及日語。請在對話中保持口述語言一致；指南建議除專有名詞外避免混用語言。口語場景應指出說話者，將台詞放入引號，再指定表達方式及相關音效。所需表演應適合選定片長。

準備參考與遵守輸入上限

文件所列參考上限為九張圖片、三段影片及三段音訊。此製作者規格不接受含真實人臉的參考圖片或影片直接上傳；人像工作採用其支援的人像素材工作流程。每段影片或音訊必須為 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，每個鏡頭有明確主體、動作、位置與聲音。指南建議每個鏡頭只安排一個鏡頭運動，並指出精確的逐鏡時間戳記不穩定。請為每個角色提供固定標籤及少數辨識特徵；若臉部身分重要，應使用分開且清楚的頭像與全身參考，而非合併的角色多面轉身圖。

模型可生成標語、字幕、對話框等常見文字，並指定其色彩、風格、位置及進場。常用字優於罕用字或特殊符號。請檢查動態中的字母與文字。文件記載可能出現不需要的字幕、標誌及重複角色；明確限制與乾淨參考可降低發生機會，但不保證完全消失。超過四位參考人物被報告為穩定性風險，並非硬性檔案數上限。

反覆延伸可能累積畫質損失，延伸接縫也可能跳動或倒退。請限制層層堆疊的延續，並在編輯中檢查接縫。參考音色可能漂移、旁白可能以喀聲結束，中文多音字或罕用字可能讀錯。請檢查台詞與結尾音訊；短音訊淡出可改善截斷。這些檢查是準備創作成果的一部分，尤其當語音或角色連貫性承載故事時。

", "aboutText": "Seedance 2.0 Fast 是 ByteDance Seed 在 Seedance 2.0 系列中以速度為導向的版本。它支援影片與音訊聯合生成，以及由文字、圖片、影片及聲音構成的多模態需求說明。創作能力包括參考導向的新場景、既有影片編輯及場景延伸，文件所述輸出等級為 480p 與 720p。\n\n### 多模態參考：為素材分配角色\n\n圖片可提供角色、產品、構圖或視覺處理。參考影片可提供動作、鏡頭運動或效果。參考音訊可提供音色、音樂旋律或對話內容。請解釋每份來源的哪個部分要帶入新場景；具備明確創作角色的參考更實用。\n\n例如：「以 Image 1 的陶瓷燈作為產品。跟隨 Video 1 的緩慢環繞鏡頭，但將燈放在安靜的閱讀角落。以 Audio 1 指定音樂情緒。」預定輸出是結合所選外觀、動作及聲音方向的新場景，而非未加指定地模仿參考中的每項細節。\n\n文件記載的組合包括圖片加音訊、圖片加影片、影片加音訊，以及三者一起使用。不支援僅有文字加音訊，或僅有音訊的輸入。模型也支援文字轉影片，以及以首幀或首尾幀配對進行圖片主導生成。若精確終點是需求核心，請使用專用終點工作流程；在 omni-reference 提示中將參考圖片描述為終點，是間接控制。\n\n### 編輯既有影片\n\n模型可新增、移除或修改元素，替換主體，並重繪或修復場景部分內容。請識別來源影片、要改變的物體及應維持的元素。新增時應描述出現位置與時間；移除時應在整段影片中一致識別該物體。\n\n實用編輯需求可將示範中的素面瓶子，替換為 Image 1 的瓶子，同時要求保留 Video 1 的手部動作、背景及攝影機路徑。請同時檢查替換內容與應保持穩定的區域。明確的保留指示，比泛泛要求「改善」影片更容易評估預定編輯。\n\n### 延伸與連接片段\n\nSeedance 2.0 Fast 支援向後續接或向前補足，並以生成轉場連接兩段或三段影片。延伸時，請指出新動作發生在輸入影片之前或之後，再描述該動作。連接時則依預定順序提供片段，並說明銜接它們的視覺事件。\n\n簡單延伸通常傳回在原影片周圍新發展的延續部分，而非假設整段來源片段會重複。若輸出應包含原區段，請在需求中明說。填補兩段或三段影片間的轉場時，文件所述工作流程可組合原始與新生成內容。這適合透過有目的的鏡頭運動，將產品全景連至細節鏡頭。\n\n### 輸出與版本差異\n\n文件所述 Fast 輸出為每秒 24 幀的 MP4、480p 或 720p、8 位元色深，以及 4 至 15 秒片段。支援比例為 21:9、16:9、4:3、1:1、3:4 及 9:16。標準 Seedance 2.0 版本另列 1080p 與 4K 輸出，這些等級不屬於 Fast 規格。2.0 系列支援傳回最後生成畫面，但不支援獨立的 Draft 預覽模式。\n\n音訊可隨影片生成，也可省略以製作無聲片段。生成音訊為單聲道。文件列出的提示語言包括英語、西班牙語、印尼語、葡萄牙語及日語。請在對話中保持口述語言一致；指南建議除專有名詞外避免混用語言。口語場景應指出說話者，將台詞放入引號，再指定表達方式及相關音效。所需表演應適合選定片長。\n\n### 準備參考與遵守輸入上限\n\n文件所列參考上限為九張圖片、三段影片及三段音訊。此製作者規格不接受含真實人臉的參考圖片或影片直接上傳；人像工作採用其支援的人像素材工作流程。每段影片或音訊必須為 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 音訊。\n\n請排列素材，並一致使用 Image 1、Video 1 或 Audio 1 參照。除了素材編號，也使用可見主體名稱或辨識特徵。終點圖片取景應符合預定影片比例，因為不一致可能裁切圖片，或造成突兀的取景變化。需求應聚焦要轉移的特徵、要生成的事件，以及應維持不變的內容；過長提示可能分散指示，讓次要細節未被解決。\n\n### 鏡頭規劃、文字與已知行為\n\n複雜需求應整理為 Shot 1、Shot 2 及 Shot 3，每個鏡頭有明確主體、動作、位置與聲音。指南建議每個鏡頭只安排一個鏡頭運動，並指出精確的逐鏡時間戳記不穩定。請為每個角色提供固定標籤及少數辨識特徵；若臉部身分重要，應使用分開且清楚的頭像與全身參考，而非合併的角色多面轉身圖。\n\n模型可生成標語、字幕、對話框等常見文字，並指定其色彩、風格、位置及進場。常用字優於罕用字或特殊符號。請檢查動態中的字母與文字。文件記載可能出現不需要的字幕、標誌及重複角色；明確限制與乾淨參考可降低發生機會，但不保證完全消失。超過四位參考人物被報告為穩定性風險，並非硬性檔案數上限。\n\n反覆延伸可能累積畫質損失，延伸接縫也可能跳動或倒退。請限制層層堆疊的延續，並在編輯中檢查接縫。參考音色可能漂移、旁白可能以喀聲結束，中文多音字或罕用字可能讀錯。請檢查台詞與結尾音訊；短音訊淡出可改善截斷。這些檢查是準備創作成果的一部分，尤其當語音或角色連貫性承載故事時。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "144be71dea8a9e125583a305b5175694edeec6941c8cde9b4d89c010b226c4fb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "zh-hant-tw", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Fast

ByteDance /bytedance/seedance-2.0-fast

入門

ByteDance Seedance 2.0 Fast 從文字、圖片、影片及聲音參考創作視聽場景。此速度導向版本支援動作與風格轉移、影片編輯，以及向後續接或向前補足的延伸；文件記載輸出為 480p 與 720p。

接受的輸入
文字 · 圖片 · 音訊
結果
影片
關於模型

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

Seedance 2.0 Fast 是 ByteDance Seed 在 Seedance 2.0 系列中以速度為導向的版本。它支援影片與音訊聯合生成，以及由文字、圖片、影片及聲音構成的多模態需求說明。創作能力包括參考導向的新場景、既有影片編輯及場景延伸，文件所述輸出等級為 480p 與 720p。

多模態參考：為素材分配角色

圖片可提供角色、產品、構圖或視覺處理。參考影片可提供動作、鏡頭運動或效果。參考音訊可提供音色、音樂旋律或對話內容。請解釋每份來源的哪個部分要帶入新場景；具備明確創作角色的參考更實用。

例如：「以 Image 1 的陶瓷燈作為產品。跟隨 Video 1 的緩慢環繞鏡頭，但將燈放在安靜的閱讀角落。以 Audio 1 指定音樂情緒。」預定輸出是結合所選外觀、動作及聲音方向的新場景，而非未加指定地模仿參考中的每項細節。

文件記載的組合包括圖片加音訊、圖片加影片、影片加音訊，以及三者一起使用。不支援僅有文字加音訊，或僅有音訊的輸入。模型也支援文字轉影片，以及以首幀或首尾幀配對進行圖片主導生成。若精確終點是需求核心，請使用專用終點工作流程；在 omni-reference 提示中將參考圖片描述為終點，是間接控制。

編輯既有影片

模型可新增、移除或修改元素，替換主體，並重繪或修復場景部分內容。請識別來源影片、要改變的物體及應維持的元素。新增時應描述出現位置與時間；移除時應在整段影片中一致識別該物體。

實用編輯需求可將示範中的素面瓶子，替換為 Image 1 的瓶子，同時要求保留 Video 1 的手部動作、背景及攝影機路徑。請同時檢查替換內容與應保持穩定的區域。明確的保留指示，比泛泛要求「改善」影片更容易評估預定編輯。

延伸與連接片段

Seedance 2.0 Fast 支援向後續接或向前補足，並以生成轉場連接兩段或三段影片。延伸時，請指出新動作發生在輸入影片之前或之後，再描述該動作。連接時則依預定順序提供片段，並說明銜接它們的視覺事件。

簡單延伸通常傳回在原影片周圍新發展的延續部分，而非假設整段來源片段會重複。若輸出應包含原區段，請在需求中明說。填補兩段或三段影片間的轉場時，文件所述工作流程可組合原始與新生成內容。這適合透過有目的的鏡頭運動，將產品全景連至細節鏡頭。

輸出與版本差異

文件所述 Fast 輸出為每秒 24 幀的 MP4、480p 或 720p、8 位元色深，以及 4 至 15 秒片段。支援比例為 21:9、16:9、4:3、1:1、3:4 及 9:16。標準 Seedance 2.0 版本另列 1080p 與 4K 輸出，這些等級不屬於 Fast 規格。2.0 系列支援傳回最後生成畫面，但不支援獨立的 Draft 預覽模式。

音訊可隨影片生成，也可省略以製作無聲片段。生成音訊為單聲道。文件列出的提示語言包括英語、西班牙語、印尼語、葡萄牙語及日語。請在對話中保持口述語言一致；指南建議除專有名詞外避免混用語言。口語場景應指出說話者，將台詞放入引號，再指定表達方式及相關音效。所需表演應適合選定片長。

準備參考與遵守輸入上限

文件所列參考上限為九張圖片、三段影片及三段音訊。此製作者規格不接受含真實人臉的參考圖片或影片直接上傳；人像工作採用其支援的人像素材工作流程。每段影片或音訊必須為 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 可用 · 輸入與方法

Ailoot Ultra · 影片 POST /v1/videos
輸入
text, image, audio
輸出
video
輸出格式
原始 MP4 位元組；不進行正規化或轉碼
欄位類型要求值與限制預設值
欄位model類型string要求必填值與限制
bytedance/seedance-2.0-fast
預設值—
欄位prompt類型string要求必填值與限制預設值—
欄位duration類型integer要求必填值與限制
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
最小值: 1
最大值: 600
預設值—
欄位resolution類型string要求選填值與限制
480p, 720p
預設值—
欄位aspect_ratio類型string要求選填值與限制
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
預設值—
欄位generate_audio類型boolean要求選填值與限制
false, true
條件: 省略 generate_audio 會選用含音訊的價格；設為 false 則會選用不含音訊的價格。請查看結果中的 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
模式: ^[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-fast

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-fast

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-fast

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.0084 每 1K 影片 Token

影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。

設定影片詞元價格費率表—預估數量—計費單位per 1,000 video tokens計費條件輸入：with_video_input費用
reference · 影片詞元價格 · 僅供比較的估算 $0.00495 每 1K 影片 Token

影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。

設定影片詞元價格費率表—預估數量—計費單位per 1,000 video tokens計費條件音訊：without_audio費用
輸出 · 影片詞元價格 · 僅供比較的估算 $0.0084 每 1K 影片 Token

影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。

設定預估生成費用費率表—預估數量單次生成估算值計費單位—計費條件—費用
輸出 · 預估生成費用 · 僅供比較的估算 $0.18144 生成前估算

此估算並非額外費用，也不是本次生成完成後的固定費率。

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

參考費率詳情

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

影片設定的價格參考

各設定的價格

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

設定計費條件費用
設定影片詞元價格計費條件此定價鍵未宣告額外條件。費用
輸出 · 影片詞元價格 $0.0084 每 1K 影片 Token

影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。

設定影片詞元價格計費條件音訊：without_audio費用
輸出 · 影片詞元價格 $0.0084 每 1K 影片 Token

影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。

設定影片詞元價格計費條件輸入：with_video_input費用
reference · 影片詞元價格 $0.00495 每 1K 影片 Token

影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。

請求範例

Ailoot Ultra · 影片

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

接收並儲存結果

Ailoot Ultra · 影片

自有內容的簽署 URL

查看工作狀態
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
其他內容讀取方式
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
保留所有已完成的結果

請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 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-fast

方法路徑別名

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

相關呼叫用 ID

bytedance/seedance-2.0-fast

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-fast", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-fast", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "請保留每個實際的自有輸出，以及回傳的實測中繼資料。", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "無法存取影片，或找不到此影片 ID。", "http_status": 404, "public_identifier_field": "error.type", "recovery": "請確認影片存取權限。若影片已存在，請使用其原始公開 ID 與相同的 API 金鑰。", "type": "not_found_error" }, { "condition": "API 金鑰與已驗證的帳號不符。", "http_status": 401, "public_identifier_field": "error.type", "recovery": "提交前，請先確認 API 金鑰與帳號存取權限。", "type": "authentication_error" }, { "condition": "無法讀取請求，或下載索引無效。", "http_status": 400, "public_identifier_field": "error.type", "recovery": "請修正請求本文。若要下載，請選擇原始工作回傳的輸出索引。", "type": "invalid_request_error" }, { "condition": "所選影片設定無法定價。", "http_status": 422, "public_identifier_field": "error.type", "recovery": "請選擇支援的影片設定，填妥其必要選項，再提交修正後的請求。", "type": "price_unavailable" }, { "condition": "影片輸入或原始延續工作無效。", "http_status": 422, "public_identifier_field": "error.type", "recovery": "請使用有效的 HTTPS 輸入。若要延續影片，請使用已完成原始影片的公開影片 ID，以及相同的 API 金鑰。", "type": "invalid_request_error" }, { "condition": "可用餘額或限制不允許預留額度。", "http_status": 402, "public_identifier_field": "error.type", "recovery": "傳送新的請求前，請先確認可用餘額與限制。", "type": "billing_error" }, { "condition": "影片驗證、儲存系統或服務存取暫時無法使用。", "http_status": 503, "public_identifier_field": "error.type", "recovery": "請等待服務恢復可用。若已有影片 ID，請查詢該原始工作，切勿另行建立生成工作。", "type": "server_error" }, { "code": "result_pending_check", "condition": "原始影片結果與費用需要查核。", "http_status": 503, "public_identifier_field": "error.code", "recovery": "請保留回傳的影片 ID，並查詢該工作。查詢期間切勿傳送替代的生成請求。", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "現有影片暫時無法下載。", "http_status": 503, "public_identifier_field": "error.code", "recovery": "請稍後查詢同一影片工作，並下載其現有輸出。新的生成請求會建立獨立操作。", "type": "server_error" }, { "condition": "影片內容尚未發布。", "http_status": 409, "public_identifier_field": "error.type", "recovery": "請查詢原始工作狀態。回報 completed 後再下載；若回報 failed，請依其費用查核通知處理。", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + 原始 id + X-Should-Retry:false；切勿重送原始請求" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "請提供文字提示詞與支援的整數秒長度。請使用列出的確切大小，或可對應至列出尺寸的解析度與長寬比。", "required": [ "model", "prompt", "duration" ], "required_material": "文字提示詞。" }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images 是物件陣列，每個物件包含 type=image_url、內含 url 的 image_url，以及 frame_type。請使用公開的 HTTPS 圖片 URL；first_frame 與 last_frame 各最多只能出現一次。請使用列出的輸出大小或相容尺寸。切勿加入影片參考資料。", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "文字提示詞與影格圖片。" }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references 是陣列。每個物件包含 type=image_url 或 type=audio_url，以及相應且內含 url 的 URL 物件。請使用公開的 HTTPS 連結。省略 frame_images 即可選擇參考資料模式。影片參考資料無法定價。", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "文字提示詞與圖片或音訊參考資料。" } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "此影片在輸出清單中的位置，索引從零開始。", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "此已完成影片的簽署 HTTPS 下載 URL。", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "原始影片位元組的 SHA-256 摘要；無法取得時為 null。", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "原始影片檔案大小，以位元組為單位；無法取得時為 null。", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "實測的影片長度，以毫秒為單位；無法取得時為 null。", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "影片寬度，以像素為單位；無法取得時為 null。", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "影片高度，以像素為單位；無法取得時為 null。", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "影片編碼識別碼；未記錄時為 null。", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "影片是否包含音軌；未測量時為 null。", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "音訊編碼識別碼；未記錄識別碼時為 null。", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "自有內容的簽署 URL", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "省略 generate_audio 會選用含音訊的價格；設為 false 則會選用不含音訊的價格。請查看結果中的 has_audio，確認是否回傳音軌。", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "這些鍵適用於每個影格物件。僅含文字的請求請省略 frame_images。", "content": "影格物件陣列。每個物件包含 type=image_url、內含 url 的 image_url，以及 frame_type=first_frame 或 last_frame。每種角色最多只能出現一次。請使用公開的 HTTPS URL。", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "省略 frame_images 即可使用參考資料模式。請使用公開的 HTTPS URL。", "content": "圖片或音訊參考物件的陣列。請將 type 設為 image_url 或 audio_url，並提供相應且內含 url 的 URL 物件。影片參考資料仍無法定價。", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "影片詞元價格", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "輸入：with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "影片詞元價格", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "此估算並非額外費用，也不是本次生成完成後的固定費率。", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "預估生成費用", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "bytedance/seedance-2.0-fast", "nativeProvenance": { "input_facts_canonical_sha256": "ba9a730672a268d0c56c0556b6dbe62e7f362afd05284e76ddd4d9104a709ce1", "input_html_sha256": "942622e27d6675cd10ca2563c02cd8d2b9de5d33fd6b7939800495bdeffc0631", "private_audit_sha256": "03a2ae82a9ce18be7a8c384f7b7c0c971d633ded0123043720ab1e7d803d2165", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0-fast/", "description": "ByteDance Seedance 2.0 Fast 從文字、圖片、影片及聲音參考創作視聽場景。此速度導向版本支援動作與風格轉移、影片編輯，以及向後續接或向前補足的延伸；文件記載輸出為 480p 與 720p。", "locale": "zh-hant-tw", "md_url": "https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0-fast/index.md", "title": "ByteDance: Seedance 2.0 Fast — Ailoot", "url": "https://ailoot.ai/models/zh-hant-tw/bytedance-seedance-2-0-fast/" }, "rawModel": { "about": "Seedance 2.0 Fast 是 ByteDance Seed 在 Seedance 2.0 系列中以速度為導向的版本。它支援影片與音訊聯合生成，以及由文字、圖片、影片及聲音構成的多模態需求說明。創作能力包括參考導向的新場景、既有影片編輯及場景延伸，文件所述輸出等級為 480p 與 720p。\n\n### 多模態參考：為素材分配角色\n\n圖片可提供角色、產品、構圖或視覺處理。參考影片可提供動作、鏡頭運動或效果。參考音訊可提供音色、音樂旋律或對話內容。請解釋每份來源的哪個部分要帶入新場景；具備明確創作角色的參考更實用。\n\n例如：「以 Image 1 的陶瓷燈作為產品。跟隨 Video 1 的緩慢環繞鏡頭，但將燈放在安靜的閱讀角落。以 Audio 1 指定音樂情緒。」預定輸出是結合所選外觀、動作及聲音方向的新場景，而非未加指定地模仿參考中的每項細節。\n\n文件記載的組合包括圖片加音訊、圖片加影片、影片加音訊，以及三者一起使用。不支援僅有文字加音訊，或僅有音訊的輸入。模型也支援文字轉影片，以及以首幀或首尾幀配對進行圖片主導生成。若精確終點是需求核心，請使用專用終點工作流程；在 omni-reference 提示中將參考圖片描述為終點，是間接控制。\n\n### 編輯既有影片\n\n模型可新增、移除或修改元素，替換主體，並重繪或修復場景部分內容。請識別來源影片、要改變的物體及應維持的元素。新增時應描述出現位置與時間；移除時應在整段影片中一致識別該物體。\n\n實用編輯需求可將示範中的素面瓶子，替換為 Image 1 的瓶子，同時要求保留 Video 1 的手部動作、背景及攝影機路徑。請同時檢查替換內容與應保持穩定的區域。明確的保留指示，比泛泛要求「改善」影片更容易評估預定編輯。\n\n### 延伸與連接片段\n\nSeedance 2.0 Fast 支援向後續接或向前補足，並以生成轉場連接兩段或三段影片。延伸時，請指出新動作發生在輸入影片之前或之後，再描述該動作。連接時則依預定順序提供片段，並說明銜接它們的視覺事件。\n\n簡單延伸通常傳回在原影片周圍新發展的延續部分，而非假設整段來源片段會重複。若輸出應包含原區段，請在需求中明說。填補兩段或三段影片間的轉場時，文件所述工作流程可組合原始與新生成內容。這適合透過有目的的鏡頭運動，將產品全景連至細節鏡頭。\n\n### 輸出與版本差異\n\n文件所述 Fast 輸出為每秒 24 幀的 MP4、480p 或 720p、8 位元色深，以及 4 至 15 秒片段。支援比例為 21:9、16:9、4:3、1:1、3:4 及 9:16。標準 Seedance 2.0 版本另列 1080p 與 4K 輸出，這些等級不屬於 Fast 規格。2.0 系列支援傳回最後生成畫面，但不支援獨立的 Draft 預覽模式。\n\n音訊可隨影片生成，也可省略以製作無聲片段。生成音訊為單聲道。文件列出的提示語言包括英語、西班牙語、印尼語、葡萄牙語及日語。請在對話中保持口述語言一致；指南建議除專有名詞外避免混用語言。口語場景應指出說話者，將台詞放入引號，再指定表達方式及相關音效。所需表演應適合選定片長。\n\n### 準備參考與遵守輸入上限\n\n文件所列參考上限為九張圖片、三段影片及三段音訊。此製作者規格不接受含真實人臉的參考圖片或影片直接上傳；人像工作採用其支援的人像素材工作流程。每段影片或音訊必須為 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 音訊。\n\n請排列素材，並一致使用 Image 1、Video 1 或 Audio 1 參照。除了素材編號，也使用可見主體名稱或辨識特徵。終點圖片取景應符合預定影片比例，因為不一致可能裁切圖片，或造成突兀的取景變化。需求應聚焦要轉移的特徵、要生成的事件，以及應維持不變的內容；過長提示可能分散指示，讓次要細節未被解決。\n\n### 鏡頭規劃、文字與已知行為\n\n複雜需求應整理為 Shot 1、Shot 2 及 Shot 3，每個鏡頭有明確主體、動作、位置與聲音。指南建議每個鏡頭只安排一個鏡頭運動，並指出精確的逐鏡時間戳記不穩定。請為每個角色提供固定標籤及少數辨識特徵；若臉部身分重要，應使用分開且清楚的頭像與全身參考，而非合併的角色多面轉身圖。\n\n模型可生成標語、字幕、對話框等常見文字，並指定其色彩、風格、位置及進場。常用字優於罕用字或特殊符號。請檢查動態中的字母與文字。文件記載可能出現不需要的字幕、標誌及重複角色；明確限制與乾淨參考可降低發生機會，但不保證完全消失。超過四位參考人物被報告為穩定性風險，並非硬性檔案數上限。\n\n反覆延伸可能累積畫質損失，延伸接縫也可能跳動或倒退。請限制層層堆疊的延續，並在編輯中檢查接縫。參考音色可能漂移、旁白可能以喀聲結束，中文多音字或罕用字可能讀錯。請檢查台詞與結尾音訊；短音訊淡出可改善截斷。這些檢查是準備創作成果的一部分，尤其當語音或角色連貫性承載故事時。", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-fast", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "完整的設定價格資訊請見詳細資料。" } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "24999f354c53561f1fcfc3f1", "label": "影片設定的價格參考", "profiles": [ { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "此定價鍵未宣告額外條件。" }, "label": "影片詞元價格", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "音訊：without_audio" }, "label": "影片詞元價格", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "輸入：with_video_input" }, "label": "影片詞元價格", "units": [ { "amount": "0.00495", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0-fast", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "請保留每個實際的自有輸出，以及回傳的實測中繼資料。", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "無法存取影片，或找不到此影片 ID。", "http_status": 404, "public_identifier_field": "error.type", "recovery": "請確認影片存取權限。若影片已存在，請使用其原始公開 ID 與相同的 API 金鑰。", "type": "not_found_error" }, { "condition": "API 金鑰與已驗證的帳號不符。", "http_status": 401, "public_identifier_field": "error.type", "recovery": "提交前，請先確認 API 金鑰與帳號存取權限。", "type": "authentication_error" }, { "condition": "無法讀取請求，或下載索引無效。", "http_status": 400, "public_identifier_field": "error.type", "recovery": "請修正請求本文。若要下載，請選擇原始工作回傳的輸出索引。", "type": "invalid_request_error" }, { "condition": "所選影片設定無法定價。", "http_status": 422, "public_identifier_field": "error.type", "recovery": "請選擇支援的影片設定，填妥其必要選項，再提交修正後的請求。", "type": "price_unavailable" }, { "condition": "影片輸入或原始延續工作無效。", "http_status": 422, "public_identifier_field": "error.type", "recovery": "請使用有效的 HTTPS 輸入。若要延續影片，請使用已完成原始影片的公開影片 ID，以及相同的 API 金鑰。", "type": "invalid_request_error" }, { "condition": "可用餘額或限制不允許預留額度。", "http_status": 402, "public_identifier_field": "error.type", "recovery": "傳送新的請求前，請先確認可用餘額與限制。", "type": "billing_error" }, { "condition": "影片驗證、儲存系統或服務存取暫時無法使用。", "http_status": 503, "public_identifier_field": "error.type", "recovery": "請等待服務恢復可用。若已有影片 ID，請查詢該原始工作，切勿另行建立生成工作。", "type": "server_error" }, { "code": "result_pending_check", "condition": "原始影片結果與費用需要查核。", "http_status": 503, "public_identifier_field": "error.code", "recovery": "請保留回傳的影片 ID，並查詢該工作。查詢期間切勿傳送替代的生成請求。", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "現有影片暫時無法下載。", "http_status": 503, "public_identifier_field": "error.code", "recovery": "請稍後查詢同一影片工作，並下載其現有輸出。新的生成請求會建立獨立操作。", "type": "server_error" }, { "condition": "影片內容尚未發布。", "http_status": 409, "public_identifier_field": "error.type", "recovery": "請查詢原始工作狀態。回報 completed 後再下載；若回報 failed，請依其費用查核通知處理。", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + 原始 id + X-Should-Retry:false；切勿重送原始請求" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "請提供文字提示詞與支援的整數秒長度。請使用列出的確切大小，或可對應至列出尺寸的解析度與長寬比。", "required": [ "model", "prompt", "duration" ], "required_material": "文字提示詞。" }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images 是物件陣列，每個物件包含 type=image_url、內含 url 的 image_url，以及 frame_type。請使用公開的 HTTPS 圖片 URL；first_frame 與 last_frame 各最多只能出現一次。請使用列出的輸出大小或相容尺寸。切勿加入影片參考資料。", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "文字提示詞與影格圖片。" }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references 是陣列。每個物件包含 type=image_url 或 type=audio_url，以及相應且內含 url 的 URL 物件。請使用公開的 HTTPS 連結。省略 frame_images 即可選擇參考資料模式。影片參考資料無法定價。", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "文字提示詞與圖片或音訊參考資料。" } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "此影片在輸出清單中的位置，索引從零開始。", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "此已完成影片的簽署 HTTPS 下載 URL。", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "原始影片位元組的 SHA-256 摘要；無法取得時為 null。", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "原始影片檔案大小，以位元組為單位；無法取得時為 null。", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "實測的影片長度，以毫秒為單位；無法取得時為 null。", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "影片寬度，以像素為單位；無法取得時為 null。", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "影片高度，以像素為單位；無法取得時為 null。", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "影片編碼識別碼；未記錄時為 null。", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "影片是否包含音軌；未測量時為 null。", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "音訊編碼識別碼；未記錄識別碼時為 null。", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "自有內容的簽署 URL", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "省略 generate_audio 會選用含音訊的價格；設為 false 則會選用不含音訊的價格。請查看結果中的 has_audio，確認是否回傳音軌。", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "這些鍵適用於每個影格物件。僅含文字的請求請省略 frame_images。", "content": "影格物件陣列。每個物件包含 type=image_url、內含 url 的 image_url，以及 frame_type=first_frame 或 last_frame。每種角色最多只能出現一次。請使用公開的 HTTPS URL。", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "省略 frame_images 即可使用參考資料模式。請使用公開的 HTTPS URL。", "content": "圖片或音訊參考物件的陣列。請將 type 設為 image_url 或 audio_url，並提供相應且內含 url 的 URL 物件。影片參考資料仍無法定價。", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "影片詞元價格", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "影片 token 費率是主要價格參考。每秒概算價格屬於另外提供的參考，並非額外費用。", "dimensions": { "conditions": "輸入：with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "影片詞元價格", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "此估算並非額外費用，也不是本次生成完成後的固定費率。", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "預估生成費用", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "bytedance/seedance-2.0-fast", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Fast", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.18144, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.18144, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000112", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000066", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.004950000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.000004950", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.000004950", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-fast", "short": "ByteDance Seedance 2.0 Fast 從文字、圖片、影片及聲音參考創作視聽場景。此速度導向版本支援動作與風格轉移、影片編輯，以及向後續接或向前補足的延伸；文件記載輸出為 480p 與 720p。" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "ByteDance Seedance 2.0 Fast 從文字、圖片、影片及聲音參考創作視聽場景。此速度導向版本支援動作與風格轉移、影片編輯，以及向後續接或向前補足的延伸；文件記載輸出為 480p 與 720p。", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "8deb03533cd7c6a876889842eb207e79a5b29996d93a2b0536136c0960b217a9", "raw_model_js_projection_sha256": "cbd5a434191b8fbaeb523aed407b6412d97b1f32a080aa782bc8e9016e9cb091", "raw_model_json_sha256": "8deb03533cd7c6a876889842eb207e79a5b29996d93a2b0536136c0960b217a9", "renderer_sha256": "13a3fc1b22d07359278e2249d630bfc9bb9e6416c71ba53def933fb5a903660b" }, "sourceRevision": "1be01d158f4e844c612f3a04a351906d90180aab2c156c0873311f74f4ce8445" }