列出一键动画任务
从源码生成 GET /animations 的鉴权、字段、响应、错误与安全调用参考。
本页目录
操作
GET /animations
operationId: list_one_click_animations_v1_animations_get
列出当前账户所属任务。将 next_cursor 原样传回获取下一页，null 表示结束。并发及限流预算按账户共享，不按 Key 独立计算。
鉴权与副作用
使用可信环境中的 Bearer API Key。所需权限：animations:read
此操作不启动付费生成，其他状态变化见上文说明。
参数
| 参数 | 位置 | 类型 | 必填 | 约束 / 默认值 | 含义 |
|---|---|---|---|---|---|
limit |
query |
integer |
否 | minimum: 1; maximum: 100; default: 20 |
本页最多记录数，不是账户并发上限。 |
cursor |
query |
string / null |
否 | — | 上一页返回的不透明 next_cursor，原样传回。 |
响应
| HTTP | 正文 | 含义 |
|---|---|---|
200 |
TaskListResponse | 成功的公开响应，示例数值仅用于说明。 |
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 |
建议等待秒数，遵循服务值并设置总体截止时间。 |
响应示例
{
"data": [
{
"created_at": "2026-08-30T00:00:00Z",
"credits": {
"charged": 0,
"held": 1,
"quoted": 1
},
"error": null,
"finished_at": null,
"id": "00000000-0000-4000-8000-000000000002",
"metadata": {},
"normalized_input": {},
"object": "animation",
"outputs": [],
"progress": 0,
"stage": "queued",
"started_at": null,
"status": "queued"
}
],
"next_cursor": null,
"object": "list"
}
相关教程
这篇文档有帮助吗？
不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。 隐私政策