# 豆包官方兼容创建视频任务

`POST /api/v3/contents/generations/tasks`

兼容火山方舟 Ark SDK 的豆包 Content Generation 创建任务接口。官方接口说明可参考火山方舟文档： https://www.volcengine.com/docs/82379/1520757 。已有豆包视频用户可以把 SDK 的 `base_url` 改为 `https://kaienapi.com/api/v3`，并把 API Key 换成 Kaien Key，调用方法保持不变。

## 请求格式
使用豆包官方 `content_generation.tasks.create` 的 JSON 结构。`content` 数组中的文本、图片、视频、音频顺序会影响生成语义，接口会按提交内容处理。参考素材按官方 `role` 语义传入，例如 `reference_image`、`reference_video`、`reference_audio`。

## Seedance 2.0 要点
- `model` 使用 `doubao-seedance-2-0-260128` 或 `doubao-seedance-2-0-fast-260128`。
- `duration` 通常支持 2 到 15 秒，按生成时长计费。
- `resolution` 常见值包括 480p、720p、1080p、4K；不同模型版本和输入类型的可用范围可能不同。
- `ratio` 使用官方比例值，例如 21:9、16:9、4:3、1:1、3:4、9:16 或 adaptive。
- 含 `video_url` 参考素材时按视频输入计费规则处理；参考视频最多传入 3 个，总时长通常不超过 15 秒。
- 实际可用范围以官方文档和接口返回为准。

## 查询任务
创建响应中的 `id` 是官方任务 ID。保存该 ID，并调用 `GET /api/v3/contents/generations/tasks/{task_id}` 查询状态。响应还会包含 `kaien_task_id` 和 `X-Kaien-Task-Id`，用于在 Kaien 控制台或统一视频接口中关联同一任务。

Tags: 视频任务