API 參考

計費與餘額

從錢包餘額扣費、按請求結算。按 token 計費的模型按每 100 萬輸入/輸出 token 計價；圖片、影片等任務型模型按次計費。失敗請求會自動退款。

#按 token 計價

輸入和輸出 token 分開計量。每個模型的完整價格會顯示在 /models 卡片；每個完成的請求會在請求日誌中顯示最終實際消費。

usage.json

{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 402,
    "total_tokens": 530
  }
}

請求開始時按最壞情況（max_tokens）預留額度，回應結束後按廠商上報的實際用量核銷——最終只為實際用量付費。

圖片、影片、TTS 等任務型模型每次成功呼叫收取固定費用。不同解析度/時長價格可能不同，請以模型卡片為準。

按次模型可以在一個模型上掛多個檔位：圖片檔位由 size 和 quality 決定，影片檔位由時長和解析度決定。提交時根據請求參數解析檔位，每檔價格都列在模型卡上。

檔位定價

size、quality、時長共同決定計費檔位——模型卡列出每檔確切價格，失敗呼叫自動退款。

請求失敗或非同步任務始終未完成時，預扣額度會自動退回。請求日誌只顯示最終實際消費，因此失敗呼叫不會看起來像一筆獨立扣費和退款。

所有用量從一個預付費錢包結算——沒有後付費帳單。除非金鑰單獨設了額度上限，所有金鑰花的都是同一份餘額。

在控制台 → 錢包儲值。可用付款通道（信用卡 / 其他供應商）和最低儲值金額以結帳頁顯示為準；兌換碼也在同一頁使用，即時到帳。

餘額不會過期。若付款成功但幾分鐘內餘額沒有變化，請附上付款單號提交工單。

餘額不夠覆蓋請求的預留估算時，呼叫立刻以 402 insufficient_quota 失敗——不產生任何扣費。儲值後重試即可；已經在跑的長串流不會被中途掐斷。

控制台 → 用量按模型、按天、按金鑰顯示 token 與花費圖表——是查看哪個專案或模型最花錢的最快方式。

控制台 → 請求日誌是面向客戶的 API 消費唯一依據。每一行包含時間、模型、token 用量或按次價格、請求 ID 和最終實際消費金額。

每筆請求日誌都帶有請求識別碼和時間戳記。對某次呼叫提交工單時，請附上那筆記錄的時間、模型和請求 ID，客服即可追蹤到準確的上游嘗試。

不儲存 prompt 內容

閘道只儲存後設資料（模型、token、費用、時間戳記、request id）——不儲存提示詞內容，除非你為了除錯而明確開啟請求記錄。

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。