API 文档 · 入门

Key 权限与限额

scope、模型白名单、累计与日限额、停用与撤销。

一个账号可以创建多个 Key，建议每个应用或环境单独一把，方便独立限额与撤销。

权限（scope）

scope	允许的操作
`tasks:create`	提交视频生成任务，会冻结并结算额度
`tasks:read`	查询本账号的任务状态与结果
`assets:read`	列出和查看素材
`assets:write`	上传、导入、重命名和删除素材

模型白名单

Key 只能调用创建时勾选的模型，并且必须是账号已获授权的模型。平台新上架模型不会自动加入旧 Key 的白名单。

限额

累计上限（必填）：该 Key 已结算 + 冻结中的金额不能超过它。
日上限（可选）：按本站时区（Asia/Shanghai）的自然日计算。
RPM 与并发上限（可选）：超过时返回 429 rate_limited，见限流。
有效期（可选）：过期后请求返回 401 invalid_api_key。

限额不足返回 402 key_limit_exceeded；账号可用额度不足返回 402 quota_exceeded。

停用与撤销

停用可随时恢复；撤销不可恢复。两者都会让使用该 Key 的请求立即返回 401，历史任务与账单仍保留。

cURL

curl https://cn-api.aitoken.tools/v1/account/quota \
  -H "Authorization: Bearer $AITOKEN_API_KEY"

# {
#   "object": "quota",
#   "currency": "CNY",
#   "available": "496.800000",
#   "reserved": "3.200000",
#   "key": { "id": "key_xxx", "total_remaining": "96.800000", "daily_remaining": null }
# }