查询账户余额 · OpenGptApi

接口说明

余额按整数微单位保存并通过公开合同格式化。此只读接口不会冻结额度；任务提交时的授权与最终结算以任务账务快照为准。

认证：Bearer API Key

请求

此接口没有路径、查询或请求体参数。

响应

JSON 接口使用统一响应信封。HTTP 状态表达请求结果，业务错误不会伪装成 HTTP 200。

HTTP	含义
`200`	请求成功
`401`	缺少或无效的 API Key
`403`	API Key 已禁用或无权访问
`500`	服务内部错误

完整成功响应示例（可选字段可能因状态不同而变化）

{
  "code": 0,
  "message": "success",
  "data": {
    "account_id": "account_01JEXAMPLE",
    "currency": "USD",
    "balance_micro": 12500000,
    "balance_usd": "12.500000",
    "available_micro": 12500000,
    "available_usd": "12.500000",
    "held_micro": 0,
    "held_usd": "0.000000",
    "net_consumed_micro": 0,
    "net_consumed_usd": "0.000000",
    "balance_expires_at": "2029-08-10T00:00:00.000Z"
  },
  "request_id": "8f25b42f-2ed1-4ad7-99de-61d7f779bc7b",
  "timestamp": "2026-08-10T00:00:00Z"
}

重要边界

需要 OGA 平台 API Key，不接受上游供应商 Key。

查看机器可读 OpenAPI