所有接口用 Bearer Key 鉴权,在「工作台 → API Key」创建。
POST /v1/jobs
Authorization: Bearer mk_live_xxx
Content-Type: application/json
{"template":"kinetic-tech","title":"标题","text":"一段文案。第二句。第三句。"}
返回 202:{"id":"job_xxx","points":10,"balance_after":990}
GET /v1/jobs/{id} → {"status":"preview_ready","preview_url":"/files/..."}
状态:queued → planning → preparing → previewing → preview_ready →rendering → done
POST /v1/jobs/{id}/render → {"status":"queued_render"}
GET /files/{id}/preview.png
GET /files/{id}/silent-with-audio.mp4
GET /v1/account → {"balance":990,"points_per_second":1}
GET /v1/templates → 模板列表
| 码 | 含义 |
|---|---|
| 401 | Key 无效或已停用 |
| 402 | 余额不足(返回 needed / balance) |
| 403 | Key 没有该 scope |
| 429 | 超过 Key 的每日点数或 RPM |