模型廣場與計費

模型廣場是選擇模型和了解呼叫價格的入口，顯示平台目前可公開提供的模型目錄。實際可呼叫範圍仍由 API Key 所屬呼叫分組和即時可用狀態決定。

如何選擇模型

依名稱搜尋，或依模型品牌、能力和介面類型篩選；
開啟詳情，確認模型支援的介面、可用分組和價格類型；
用 GET /v1/models 確認該 Key 可見的模型 ID；
在業務後端使用傳回的模型 ID 發起請求。

模型目錄欄位

GET /v1/models 傳回目前 Key 可呼叫的模型，欄位說明如下：

欄位	類型	說明
`data[].id`	string	模型 ID，提交請求時原樣填寫
`data[].object`	string	固定為 `model`
`data[].created`	integer	目錄記錄時間（Unix 秒）
`data[].owned_by`	string	模型的提供方識別碼，僅供參考
`data[].supported_endpoint_types`	string[]	該模型可用的介面類型

模型目錄只用於確認「這個 Key 能不能呼叫這個模型」，具體參數限制（參考圖數量、輸入影片規格、輸出時長與清晰度等）以模型詳情頁和介面傳回的參數錯誤為準。平台不會替模型猜測參數，也不會在不支援的參數上無提示降級。

價格卡片怎麼讀

顯示	含義
輸入 / 輸出	依輸入和輸出 Token 分別計費，單位顯示為 `1K` 或 `1M` Token。
快取輸入 / 快取寫入	只有支援提示詞快取的模型才會顯示。
按次	每次成功請求依固定價格計費。
影片依量計費	影片模型依目前生效價格顯示；未提供價格的解析度、時長或模式不顯示。

價格顯示用於預估，實際扣費以請求實際使用量、請求所屬分組和伺服器端帳單記錄為準。

影片模型

doubao-seedance 和 seedance 系列會顯示獨立的價格矩陣，依「是否含影片輸入」和「輸出解析度」拆分，支援的儲存格給出影片費用，不支援的組合明確顯示「不支援」。

閱讀矩陣時，先確定本次是否提交影片輸入，再選擇需要的解析度。例如只上傳文字或圖片參考時應看「不含影片輸入」一欄；提交影片作為輸入時應看「含影片輸入」一欄。不要依相鄰級距推測未顯示的價格或能力。

呼叫前請確認：

模型 ID 出現在你的 /v1/models 回應中；
請求使用影片介面 /v1/video/generations，而不是文字介面；
參考圖或參考影片符合該模型的公開參數要求；
業務端為非同步任務保存並輪詢傳回的任務 ID。

素材引用與模型

素材入庫與模型無關：素材只需要入庫一次，平台會依目前模型準備對應的素材引用。同一個素材 ID 可以在不同模型之間直接切換使用，切換模型只需要改請求裡的 model 欄位。

哪些模型共用同一套素材庫、以及真人素材支援哪些模型，見素材庫介面。

計費與帳單

模型廣場顯示的是價格說明，不等於最終結算金額。文字模型通常依實際輸入、輸出和快取用量結算；圖片、音訊或影片模型可能按次、依時長或依模型定義的計量單位結算。

影片等非同步任務在完成時結算：提交成功只受理任務，不會預先扣費，任務完成後帳單裡只會出現一筆實際扣費記錄。提交前平台會驗證帳戶餘額（或目前 API Key 額度）是否足以支應本次預估，不足時會直接傳回可讀提示，不會建立任務。任務完成後可在錢包或用量記錄中核對模型、時間、請求 ID 和實際扣費。

參數驗證失敗（HTTP 400）表示請求未被受理，通常不會產生生成任務費用；已傳回任務 ID 後的計費、失敗和退款規則依該模型與平台價格設定處理。

可用性變化

模型卡片不顯示或 /v1/models 中不存在某個模型，表示它目前不屬於該 Key 的可用目錄，請切換同類模型，不要在用戶端寫死已不可用的模型名稱。

「無可用通道」「模型暫不可用」表示目前時段無法路由到該模型，不代表 API Key 格式錯誤。先重新整理模型清單或切換同類模型；持續不可用時再聯絡平台支援並提供請求 ID。

本頁目錄