# API 概览

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

**接入地址**：向开户人员索取接入地址。

## 认证

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

```bash
Authorization: Bearer ${CHENVOYA_API_KEY}
```

## 错误格式

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

全部错误码及处理办法见「[错误码](./api-docs-zh-api-errors.md)」。

## 全部接口

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | `/v1/video/generations` | [创建视频任务](./api-docs-zh-api-video-tasks-create.md) |
| GET | `/v1/video/tasks/{task_id}` | [查询视频任务](./api-docs-zh-api-video-tasks-retrieve.md) |
| GET | `/v1/video/tasks` | [列出团队任务](./api-docs-zh-api-video-tasks-list.md) |
| POST | `/v1/video/tasks/{task_id}/cancel` | [取消视频任务](./api-docs-zh-api-video-tasks-cancel.md) |
| GET | `/v1/video/tasks/{task_id}/billing` | [查询单任务账单](./api-docs-zh-api-video-tasks-billing.md) |
| POST | `/v1/assets` | [登记素材](./api-docs-zh-api-assets-create.md) |
| GET | `/v1/assets/{asset_id}` | [查询素材状态](./api-docs-zh-api-assets-retrieve.md) |
| 回调 | `task.completed` | [接收任务完成通知](./api-docs-zh-api-events-task-completed.md) |
| 回调 | `task.billing_settled` | [接收任务结算通知](./api-docs-zh-api-events-task-billing-settled.md) |