账户管理

查询账户积分

查询 API Key 或 OAuth token 所属正式账户的积分钱包。

接口

GET/api/v1/developer/credits

鉴权与 Scope

Authorization: Bearer <credential>；仅接受正式账户 API Key / OAuth。

Scope: credits:read

API Key 与 OAuth token 读取所属正式 PerchanceAI 账户的同一钱包，多个密钥共享账户余额。三个余额字段当前返回同一账户积分值，单位依实际返回的 currency。

请求参数

无请求 body 或查询参数。

curl --request GET \
  --url 'https://api.perchanceai.art/api/v1/developer/credits' \
  --header 'X-App-Id: perchanceai' \
  --header 'X-Request-Id: docs-example' \
  --header 'Authorization: Bearer <formal_account_credential>'

响应 HTTP 200

以下为说明响应结构的示例，并非实时 API 响应。示例数值和 USD 不代表固定定价或资金余额。空字段省略。

REST 成功响应为 success、code、message、request_id 和 data；下表描述 data。

字段	类型	必填	说明
`mode`	string	是	正式账户凭据返回 formal。
`balance_credits / available_credits / remaining_credits`	integer	是	当前三项返回同一账户积分值，单位依实际返回的 currency。
`currency`	string	是	账户货币配置；不得据此推断资金余额或固定定价。

{
  "success": true,
  "code": "OK",
  "message": "OK",
  "request_id": "docs-example",
  "data": {
    "mode": "formal",
    "balance_credits": 120,
    "available_credits": 120,
    "remaining_credits": 120,
    "currency": "USD"
  }
}

相关错误

401 — DEVELOPER_TOKEN_REQUIRED
401 — DEVELOPER_TOKEN_INVALID / DEVELOPER_TOKEN_EXPIRED / DEVELOPER_TOKEN_REVOKED
403 — DEVELOPER_SCOPE_INSUFFICIENT

缺 bearer 返回 REQUIRED；无效凭据（包括历史匿名令牌）返回 INVALID。过期或撤销凭据使用对应错误码。

{
  "success": false,
  "code": "DEVELOPER_TOKEN_REQUIRED",
  "message": "A developer bearer token is required.",
  "request_id": "docs-example"
}