查询账户余额
端点
GET
/v1/billing/balance查询当前 API Key 所属账户的可用余额。账户身份从 API Key 识别,无需其他参数。
请求
鉴权使用 Authorization: Bearer sk-moyiapi-xxxxxx,无查询参数。
参数
无。
响应
{
"balance": {"value": "85.320000", "currency": "USD"}
}
| 字段 | 说明 |
|---|---|
balance.value |
可用余额,字符串金额 |
balance.currency |
币种 |
示例
curl "https://moyiapi.cn/v1/billing/balance" \
-H "Authorization: Bearer sk-moyiapi-xxxxxx"
错误
| HTTP 状态 | error.type |
触发条件 |
|---|---|---|
| 401 | missing_auth_credential / invalid_bearer_token |
鉴权失败,详见鉴权 |