目录

积分余额

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		每个限时发放对应一个条目，每个条目为 { id, amount, walletType, expiredAt }。
scopedAmounts
object		限定用途的发放额度，键为 scope id，1 表示 Nano Banana 图像额度。不计入 totalAmount：只能用于该 scope 指定的任务。
部分积分会过期 订阅和赠送发放的积分为限时积分，会连同 expiredAt 日期显示在 expiringWallets 中。永不过期的购买积分则计入 unlimitedAmount。
Nano Banana 额度 付费方案每月获赠仅可用于 nano-banana、nano-banana-2 和 nano-banana-pro 的图像额度，并会先于普通积分扣除。它通过 scopedAmounts 返回，且有意不计入 totalAmount——因此 totalAmount 为 0 并不代表 Nano Banana 请求会失败。请一并检查 scopedAmounts["1"]。
费用与限制 此端点仅返回余额。各任务的费用和请求速率限制，请参见 积分与速率限制。