查询账户与限额

从源码生成 GET /account 的鉴权、字段、响应、错误与安全调用参考。

公开测试API v1 · 1.3.0最后核实 2026-08-30

本页目录

操作

GET /account

operationId: account_v1_account_get

读取当前账户、开发者访问档位、可选订阅周期、Key 标识及权限和账户级限额，不返回密钥。订阅会提高限额，但不是访问前提。恢复结果不明的幂等创建时，应保持相同 Key 身份。

鉴权与副作用

使用可信环境中的 Bearer API Key。所需权限：animations:read

此操作不启动付费生成，其他状态变化见上文说明。

参数

无路径、查询或操作专属请求头参数。

响应

HTTP	正文	含义
`200`	AccountResponse	成功的公开响应，示例数值仅用于说明。
`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`	建议等待秒数，遵循服务值并设置总体截止时间。

响应示例

json

{
  "api_key": {
    "id": "00000000-0000-4000-8000-000000000005",
    "scopes": [
      "animations:read",
      "animations:write"
    ]
  },
  "id": "00000000-0000-4000-8000-000000000004",
  "limits": {
    "concurrency": 1,
    "create_per_minute": 3,
    "other_per_minute": 60,
    "queue": 3
  },
  "object": "account",
  "plan": {
    "cancel_at_period_end": false,
    "code": "registered",
    "current_period_end": null
  }
}

这篇文档有帮助吗？

允许文档使用分析

不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。隐私政策

需要帮助？联系支持

搜索文档

查询账户与限额

操作

鉴权与副作用

参数

响应

响应头

响应示例

相关教程

这篇文档有帮助吗？