API クレジット

API クレジット

Rivya API 呼び出しがアカウントクレジット、残高確認、予約クレジット、失敗タスクの返還、クレジットのトラブルシュートをどのように扱うかを理解します。

2026/05/10 最終レビュー

Rivya API は Studio と同じアカウントクレジットウォレットを使用します。

API キーのアカウントの現在残高を読み取るには、GET /api/v1/credits を使います。

エンドポイント

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

必須ヘッダー:

Authorization: Bearer rvya_sk_...

応答

{
  "current_credits": 123
}

生成の課金

生成を送信すると、Rivya はアカウントに十分なクレジットがあるかを確認します。

画像、動画、音声ジョブでは、通常タスク開始時にクレジットが予約または消費されます。生成の応答には次が含まれます。

reserved_credits
final_credits

ジョブがまだ queued または processing の間は、final_credits が 0 のままになる場合があります。

失敗したジョブ

タスクが Rivya の既存の失敗ルールに従って失敗した場合、返還処理は Studio と同じ製品ポリシーに従います。

最終ステータスを確認するには生成ステータスを使い、製品レベルの失敗モデルについては失敗タスクとクレジット返還を参照してください。

よくあるクレジットエラー

insufficient_credits: アカウントに十分なクレジットがありません
api_key_invalid: API キーからアカウントを特定できません
public_api_disabled: 公開 API が一時的に無効化されています

関連ページ

Chat API ガイド

Rivya Chat API を使い、非ストリーミングまたは SSE のターン、API 作成セッション、file_id 画像添付、token ベースのクレジット精算を扱います。

API エラーと制限

Rivya API の公開エラーコード、HTTP ステータス値、レート制限、冪等性の衝突、リトライ判断を扱います。