常見問題
計費與額度
服務額度如何扣費、何時需要儲值,以及 402 回應的含義。
Felo API Platform 的 API 使用採預付制。你購買以美元計價的服務額度,每次請求會依適用費率從該餘額扣款。
計費方式
- 儲值購買的是服務額度,不是平台代管的現金餘額。
- 額度以美元計價,因此費用可用美元表示。
- 儲值從 $1 起。無需訂閱。
- 額度僅用於抵扣平台 API 費用,不可提領或兌換現金。
- 已完成的儲值不可退款,包括未使用的額度,除非強制適用的法律另有要求。
同一份額度餘額支付模型呼叫、Data API 呼叫與 Felo API 呼叫。你不需要為每個供應商建立個別帳號或餘額。
一次請求的費用
費用取決於 endpoint:
| API 層 | 計費基礎 |
|---|---|
| Model API | 輸入、輸出與快取的 token 費率,加上任何可計費工具;適用該通道的折扣乘數 |
| Data API | 該 endpoint 公布的計費基礎,可能是每次成功請求、每個回傳項目,或依實際用量 |
Felo APIs(/v2) | 該工作流程輸出的費率 |
模型價格以每 1M tokens 顯示於價格頁面與各模型頁面。公式與估算範例請參閱模型與價格。
查看餘額與儲值
開啟 Console Billing。主控台會顯示目前額度餘額、儲值金額與用量記錄。可用付款方式依地區而異,並在結帳時顯示。
402 回應
402 表示餘額不足以支付本次呼叫:
{
"status": 402,
"code": "INSUFFICIENT_CREDITS",
"message": "...",
"request_id": "..."
}處理方式:
- 在 Console Billing 檢查餘額。
- 儲值。
- 重新送出請求。402 不是限流,等待不會讓它消失。
對非同步任務而言,提交時收到 402 表示任務從未建立。重新提交前請先檢查任務的狀態 endpoint。
計費與限流的差別
這是兩種不同的限制:
- 額度限制你能花多少。用完會回傳 402。
- 限流限制你能多快呼叫。超過會回傳 429。
429 的標頭與重試規則請參閱錯誤、限流與重試。
訂閱與額度
API 使用一律以服務額度支付。本文件唯一提到的訂閱行為,是擁有有效付費 Felo 訂閱的帳號在 /v2/chat 的限流豁免;它不會取代服務額度。
計費問題
若對費用有爭議,或儲值未入帳,請聯絡支援並提供:
- 帳號 email
- 收費的大致時間
- 任何相關錯誤的
request_id - 儲值金額與付款參考編號
絕不要送出完整的 API key。