Felo API PlatformFelo API Platform

常見問題

計費與額度

服務額度如何扣費、何時需要儲值,以及 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": "..."
}

處理方式:

  1. 在 Console Billing 檢查餘額。
  2. 儲值。
  3. 重新送出請求。402 不是限流,等待不會讓它消失。

對非同步任務而言,提交時收到 402 表示任務從未建立。重新提交前請先檢查任務的狀態 endpoint。

計費與限流的差別

這是兩種不同的限制:

  • 額度限制你能花多少。用完會回傳 402。
  • 限流限制你能多快呼叫。超過會回傳 429。

429 的標頭與重試規則請參閱錯誤、限流與重試。

訂閱與額度

API 使用一律以服務額度支付。本文件唯一提到的訂閱行為,是擁有有效付費 Felo 訂閱的帳號在 /v2/chat 的限流豁免;它不會取代服務額度。

計費問題

若對費用有爭議,或儲值未入帳,請聯絡支援並提供:

  • 帳號 email
  • 收費的大致時間
  • 任何相關錯誤的 request_id
  • 儲值金額與付款參考編號

絕不要送出完整的 API key。

相關