查询积分余额
从源码生成 GET /credits/balance 的鉴权、字段、响应、错误与安全调用参考。
本页目录
操作
GET /credits/balance
operationId: credits_balance_v1_credits_balance_get
读取 Web 与 API 共用的可用积分。已验证账户可使用 API，但产生费用的生成仍要求积分充足；消费前先为目标操作报价。
鉴权与副作用
使用可信环境中的 Bearer API Key。所需权限：animations:read
此操作不启动付费生成，其他状态变化见上文说明。
参数
无路径、查询或操作专属请求头参数。
响应
| HTTP | 正文 | 含义 |
|---|---|---|
200 |
CreditsBalanceResponse | 成功的公开响应，示例数值仅用于说明。 |
400 |
APIErrorEnvelope | 输入错误，修正请求后再尝试。 |
401 |
APIErrorEnvelope | API Key 缺失、到期或被撤销。 |
403 |
APIErrorEnvelope | 账户资格、账户状态或 Key 权限不允许此操作。 |
404 |
APIErrorEnvelope | 资源不可用、不属于当前用户，或签名无效/过期。 |
429 |
APIErrorEnvelope | 触发账户级速率或队列限制，遵循 Retry-After 等待。 |
500 |
APIErrorEnvelope | 内部错误，保留任务 ID 和幂等键，仅标记可重试时重试。 |
503 |
APIErrorEnvelope | 服务或供应商不可用，仅 error.retryable 为 true 时重试。 |
响应头
| HTTP | 响应头 | 类型 | 含义 |
|---|---|---|---|
429 |
Retry-After |
integer |
建议等待秒数，遵循服务值并设置总体截止时间。 |
503 |
Retry-After |
integer |
建议等待秒数，遵循服务值并设置总体截止时间。 |
响应示例
{
"available": 1,
"object": "credit_balance"
}
相关教程
这篇文档有帮助吗？
不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。 隐私政策