视频生成 API 文档

一套接口、一种返回格式，覆盖全部视频模型。调用方只需更换 model 取值，请求体、响应体、轮询方式完全一致。

三个要点

1. 提交任务：POST /v1/contents/generations/tasks

2. 轮询结果：GET /v1/contents/generations/tasks/{task_id}

3. 认证：请求头 Authorization: Bearer <API Key>

每一页右上角都可以复制全文或下载为 Markdown，方便存档或喂给 AI 助手。

文档目录

拿到 API Key 后，用三条 curl 走完「提交 → 轮询 → 取视频」的完整闭环。

两个端点的完整字段表、请求与响应示例、状态取值、素材要求与常见问题。

两个可选 model id 的能力与差异：单次生成时长 15 秒 / 30 秒。

2.5 上声明生成 / 编辑 / 延长意图，避免任务在 1~2 分钟后才失败。

积分如何计算、失败如何退款、各类错误码的含义与排查方向。

无论用哪个模型，请求体都是同一个结构（content[] 数组描述文本与素材），响应体也是同一个结构（id / status / content.video_url）。切换模型不需要改任何代码，只改 model 字段的值。

视频生成耗时较长，接口采用「提交拿任务号、轮询取结果」的两段式：提交成功后立刻返回 id，之后由调用方按自己的节奏轮询，直到状态变为终态。

任务在下游失败时会自动把已扣积分退回，不需要调用方申请。详见计费与错误码。