カタログ

クレジット残高

GET/v1/credits

呼び出したキーの使用可能なクレジット残高を確認します。合計・無期限・まもなく期限切れの内訳を返します。

リクエスト

リクエスト
curl https://api.picoberry.ai/v1/credits \
  -H "Authorization: Bearer pb_live_xxx"
requests.get("https://api.picoberry.ai/v1/credits", headers=headers).json()["data"]
const credits = (await (await fetch(`${BASE}/v1/credits`, { headers })).json()).data;

レスポンス

レスポンス · 200
{ "success": true, "data": {
  "totalAmount": 4200,
  "unlimitedAmount": 4000,
  "limitedAmount": 200,
  "expiringSoonAmount": 200,
  "nextExpirationDate": "2026-09-01T00:00:00.000Z",
  "expiringWallets": [
    { "id": "019…", "amount": 200, "walletType": "subscription", "expiredAt": "2026-09-01T00:00:00.000Z" }
  ],
  "scopedAmounts": { "1": 149590 }
} }

フィールド

フィールド説明
totalAmount
integer		今すぐ使用可能な合計クレジット。
unlimitedAmount
integer		無期限の部分。
limitedAmount
integer		有効期限がある部分。
expiringSoonAmount
integer		近いうちに期限切れになるクレジット。
nextExpirationDate
string · null		次の期限切れの ISO 8601 日付。期限切れの予定がない場合は null。
expiringWallets
array		期限付きの付与ごとに1項目。各項目は { id, amount, walletType, expiredAt }。
scopedAmounts
object		用途が限定された付与分。キーは scope id で、1 はナノバナナ画像の付与分です。totalAmount には含まれません: その scope が指定するタスクにのみ使用できます。
一部のクレジットは期限切れになります サブスクリプションやボーナスの付与分は期限付きで、expiredAt の日付とともに expiringWallets に表示されます。無期限の購入分は unlimitedAmount に含まれます。
ナノバナナ付与分 有料プランには nano-banana・nano-banana-2・nano-banana-pro にのみ使える月間画像付与分があり、通常クレジットより先に消費されます。scopedAmounts で報告され、totalAmount には意図的に含めていません — つまり totalAmount が 0 でもナノバナナのリクエストが失敗するとは限りません。scopedAmounts["1"] も確認してください。
コストと制限 このエンドポイントは残高のみを返します。各ジョブのコストとリクエストのレート制限については、クレジットとレート制限を参照してください。