クレジット

PC 版と共有する残高、消費、返金。

GET /credits/balance は現在の PC クレジットを返し、policysame_as_pc です。付与元、有効期限順、消費順、失敗返金はすべて PC 版と同じです。API はクレジットを付与せず、専用ウォレットや予約表を作りません。

Provider を呼び出す前に、PC と共有するトランザクションでクレジットを原子的に予約します。送信失敗が確定した場合、予約は一度だけ返金されます。API 専用の日次クレジット上限はなく、アカウントの現在有効な PC 共通残高がクレジット上限です。生成コストが利用可能残高を超える場合、Provider を呼び出さず insufficient_credits を返します。

レスポンススキーマ:

{
  "object": "credit_balance",
  "available_credits": 1200,
  "unit": "credits",
  "policy": "same_as_pc"
}