API v1

API 概览

接入地址、认证、错误格式和全部接口。

查看 Markdown

接入地址

正在读取接入地址…

所有请求路径都接在这个地址后面，例如 POST /v1/video/generations。示例把它放在 CHENVOYA_BASE_URL 环境变量里，末尾不带斜杠。

认证

客户接口使用 Bearer 方案的 API Key，通过请求头传递。本地将值保存在 CHENVOYA_API_KEY 环境变量，示例仅引用变量名。不要将实际值粘贴进文档或日志。

Authorization: Bearer ${CHENVOYA_API_KEY}

错误格式

错误响应包含 error 对象和 trace_id；error.code 是机器可读错误码，message 是说明，可选 details 提供结构化详情。下文按各操作合同列出错误与状态，不根据说明推断额外重试或收费承诺。

全部错误码及处理办法见「错误码」。

全部接口

POST/v1/video/generations创建视频任务 GET/v1/video/tasks/{task_id}查询视频任务 GET/v1/video/tasks列出团队任务 POST/v1/video/tasks/{task_id}/cancel取消视频任务 GET/v1/video/tasks/{task_id}/billing查询单任务账单 POST/v1/assets登记素材 GET/v1/assets/{asset_id}查询素材状态回调task.completed接收任务完成通知回调task.billing_settled接收任务结算通知