鉴权用控制台创建的 API Key（Authorization: Bearer sk-…），权限按能力分格：只做文本改写的 Key 可以不持有烧显卡的那一格。
计费与网页端同一条账本：提交时按最低档预扣，跑完按实际用量结算，失败的任务不计费。参数以接口目录为准，未知参数直接报错而不是静默丢弃。
两个接口
curl -X POST https://autostory.cn/openapi/v1/tasks/generate \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{"task_type":"video_generate","params":{"prompt":"女孩推开旧书店的门","duration":5}}'
curl https://autostory.cn/openapi/v1/tasks/任务ID \
-H "Authorization: Bearer sk-你的APIKey"能力与权限
提交时用 task_type 指定做哪一件事，API Key 按能力分格授权，只需要某几项的 Key 可以不持有烧显卡的那一格。
| 能力 | task_type | 所需权限 |
|---|---|---|
| 剧本生成 | script_generate | script:gen |
| 剧本分镜 | script_split | script:gen |
| 文生图 | image_generate | image:gen |
| 图生图 | image_edit | image:gen |
| 文生视频 | video_generate | video:gen |
| 首尾帧生视频 | video_first_last | video:gen |
| 参考生视频 | video_reference | video:gen |
| 视频合成 | video_compose | video:edit |
| 视频超分 | video_upscale | video:edit |
| 视频插帧 | video_interpolate | video:edit |
| 视频转码 | video_transcode | video:edit |
| 音色定制 | voice_design | audio:tts |
| 音频克隆 | voice_clone | audio:tts |
| 音频合成 | audio_synthesize | audio:tts |
目录是准的
参数名、枚举、默认值与上限全部由服务端目录给出，文档与本页都由它派生：
GET https://autostory.cn/openapi/v1/capabilities
GET https://autostory.cn/openapi/v1/pricing接口逐条说明与错误码在开发文档；网页端与接口端扣的是同一个账户余额。
常见问题
- 接口调用要单独开通或单独付费吗？
- 不需要。用同一个账户余额，网页端和接口端扣的是同一笔钱，没有接口套餐、没有最低消费。
- 能拿到产物文件吗？链接多久失效？
- 任务完成后返回签名直链，图片、视频、音频都是这个形式。直链 24 小时过期，需要长期留存请自己转存。
- 任务失败了会扣费吗？
- 不会。失败的任务按零元结算，提交时预扣的部分解冻回余额。
- 接口目录和文档哪个是准的？
- 目录是准的：
GET /openapi/v1/capabilities免 Key 可查，参数、枚举、默认值与上限都在这里，文档由它派生，不会出现文档写一套、接口收一套。