API 文档 · 参考
接口参考（OpenAPI）
下载 openapi.json 与接口一览。
完整接口定义以 OpenAPI 3.1 发布，可直接导入 Postman、Apifox 或用于生成 SDK。它与服务端校验来自同一份 schema。
开放接口一览
| 方法与路径 | 用途 | scope |
|---|---|---|
GET /v1/models | 本 Key 可用的模型、能力与价格 | 有效 Key |
POST /v1/uploads | 申请上传 | assets:write |
POST /v1/uploads/{id}/parts | 申请分片地址 | assets:write |
POST /v1/uploads/{id}/complete | 完成上传 | assets:write |
POST /v1/assets | 由 upload_id 或 source_url 创建素材 | assets:write |
GET /v1/assets | 分页列出素材 | assets:read |
GET · PATCH · DELETE /v1/assets/{id} | 查看、重命名、删除素材 | assets:read / write |
/v1/asset-groups | 素材分组 | assets:read / write |
POST /v1/videos/generations | 创建视频任务 | tasks:create |
GET /v1/videos/generations/{id} | 查询任务 | tasks:read |
GET /v1/videos/generations | 分页查询任务 | tasks:read |
GET /v1/account/quota | 账号与当前 Key 的剩余额度 | 有效 Key |
所有路径都相对于 https://cn-api.aitoken.tools/v1。