API 點數

API 點數

了解 Rivya API 呼叫如何使用帳號點數、餘額檢查、預留點數、失敗任務退款和點數疑難排解。

最近審閱於 2026/05/10

Rivya API 使用與 Studio 相同的帳號點數錢包。

使用 GET /api/v1/credits 讀取 API key 所屬帳號的目前餘額。

Endpoint

GET https://rivya.ai/api/v1/credits

必要 header：

Authorization: Bearer rvya_sk_...

回應

{
  "current_credits": 123
}

生成計費

提交生成任務時，Rivya 會檢查帳號是否有足夠點數。

圖片、影片和音訊任務通常會在任務開始時預留或消耗點數。生成回應包含：

reserved_credits
final_credits

當任務仍在排隊或處理中時，final_credits 可能仍為 0。

失敗任務

如果任務依照 Rivya 既有失敗規則失敗，退款處理會遵循與 Studio 相同的產品政策。

使用生成狀態確認最終狀態，並參考失敗任務與點數退款了解產品層級的失敗模型。

常見點數錯誤

insufficient_credits：帳號沒有足夠點數
api_key_invalid：API key 無法識別帳號
public_api_disabled：公開 API 暫時停用

相關頁面

Chat API

使用 Rivya Chat API 發送非串流或 SSE 回合、API 建立的工作階段、file_id 圖片附件，並依 token 結算點數。

API 錯誤與限制

處理 Rivya API 公開錯誤碼、HTTP 狀態值、速率限制、冪等衝突和重試判斷。