聊天計費

API 使用預付點數。在控制臺的 錢包 → 儲值點數 中儲值，也可以選擇訂閱，無需訂閱也能呼叫 API。錢包中可查看 API 餘額與流水。

價格

價格表 和 GET /v1/chat/catalog 與實際扣費使用同一份後臺配置。 聊天按輸入和輸出 token 的每百萬單價計費，語音按每千字元的單價折算，每個模型可單獨改價。 請讀取目錄中的即時價格，不要寫死。 聊天標準響應包含 usage，實際點數請在 Usage history 或 Credit transactions 中核對；只有語音響應額外包含 billing。

扣費與退款

• Chat 呼叫前預留點數，返回後按實際 token 用量結算，多余點數自動退回。
• 輸入包括歷史消息和人物設定。所有輸入（包括快取命中部分）統一使用輸入單價；推理已包含在輸出中，不重復收費。
• 合計費用向上保留 8 位小數。上游缺失或返回無效用量時釋放預留點數並返回 503。
• 語音合成單獨收費，朗讀聊天回復也會產生語音費用。
• 上游呼叫失敗時自動退款。
• 餘額不足時返回 402 insufficient_balance。
• Chat 同步返回回復，不進入生成任務列表。

錢包流水中，hold 表示預留，refund 表示退回未使用部分，charge 表示從預留中結算的實際消耗。預留額不能與實際消耗相加。語音使用 consume 記錄消耗。

文本聊天見 OpenAI 相容聊天，語音與音色見語音與模型目錄。

語音計費

語音按清理後的計費字元數計算，向上保留八位小數，不足千字元也按實際數量計算。Speech Light、Speech Pro 和 Speech Expressive 按 UTF-16 單位計數，與上游一致：普通中文、英文字母計 1，😀 等補充平面字元計 2；Speech Standard 按 Unicode 碼點計數。目錄的 speechModels[].characterCounting 和響應的 billing.character_counting 標明計數規則。例如每千單位 0.7 點數時，100 個計費單位消耗 0.07 點數，此數字僅為計算示例。合成失敗退款；未知或不可用模型在扣費前拒絕。

本地測試餘額

Stripe 測試支付增加獨立的沙盒餘額，不能用於真實 API 呼叫。本地聯調時，管理員可在後臺為測試使用者的 API 餘額儲值。402 表示 API 餘額不足，與沙盒支付餘額無關。正式支付確認後會增加 API 餘額。 型