跳到主要内容

账户余额 · account/credits

GET /v1/account/credits

返回调用方账户的余额/配额。免费,不计费,可用于监控用量或在扣费前预检。

请求示例​

curl "https://one1.cn/v1/account/credits" \
  -H "Authorization: Bearer one1_live_xxxxxxxx"

响应​

返回当前账户的 API 点余额与构成:本月配额、已用、长期赠送点,以及 API 档位;成功响应头带 X-Quota-Remaining(= balance;无限量账户不发)。以此判断是否需要升级或续费。

{
  "plan": "…",
  "unlimited": false,
  "balance": 18760,
  "breakdown": { "monthly_quota": 20000, "used": 1240, "gift": 0 },
  "period": "2026-10",
  "tier": "starter",
  "tier_cn": "入门版",
  "request_id": "3f9a1c2b7d4e8f01",
  "timestamp": "2026-10-10T07:20:01Z"
}
字段类型说明
planstring账户所属 One1 套餐代码
unlimitedbool是否无限量账户;为 true 时 balance 与 breakdown 为 null,且不发 X-Quota-Remaining
balanceint 或 null本月剩余 API 点(含赠送点),与成功响应头 X-Quota-Remaining 同值
breakdown.monthly_quota / used / giftint本月套餐点、已用点、长期赠送点;第三方数据源接口可用余额 = monthly_quota − used
periodstring计费周期(UTC,YYYY-MM)
tier / tier_cnstringAPI 档位代码与中文名:free 免费版 / starter 入门版 / growth 成长版 / scale 企业版
request_idstring本次请求的追踪 ID,与响应头 X-Request-Id 同值
timestampstring服务端响应时间,UTC ISO 8601 带 Z