curl --request POST \
  --url https://kaienapi.com/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "生成一段产品展示视频，镜头平稳推进"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      },
      "role": "reference_image"
    }
  ]
}
'

{
  "id": "cgt-xxx",
  "kaien_task_id": "task_xxx"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

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

兼容火山方舟 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 控制台或统一视频接口中关联同一任务。

POST

api

contents

generations

tasks

curl --request POST \
  --url https://kaienapi.com/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "生成一段产品展示视频，镜头平稳推进"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      },
      "role": "reference_image"
    }
  ]
}
'

{
  "id": "cgt-xxx",
  "kaien_task_id": "task_xxx"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

在请求头中传入：Authorization: Bearer sk-...

Body

application/json

model

string

required

豆包官方模型 ID。Seedance 2.0 Fast 使用 doubao-seedance-2-0-fast-260128。

Example:

"doubao-seedance-2-0-260128"

content

object[]

required

官方 content 数组。文本、图片、视频、音频按数组顺序传入；提示词中引用“图片 n / 视频 n / 音频 n”时顺序会影响生成结果。

Show child attributes

duration

integer

生成时长，单位秒。Seedance 2.0 系列通常支持 2 到 15 秒，实际可用范围以官方文档和接口返回为准。

resolution

string

输出分辨率。Seedance 2.0 系列常见值包括 480p、720p、1080p、4K；不同模型版本和输入类型的可用范围可能不同，以官方文档和接口返回为准。

ratio

string

输出比例，例如 21:9、16:9、4:3、1:1、3:4、9:16 或 adaptive。

Example:

"16:9"

generate_audio

boolean

watermark

boolean

return_last_frame

boolean

service_tier

string

Example:

"flex"

tools

object[]

seed

integer

Response

官方创建任务响应

string

官方任务 ID。后续查询时原样传入 task_id。

kaien_task_id

string

Kaien 任务 ID。需要在 Kaien 统一视频接口、控制台或日志中关联同一任务时使用。

status

string

任务状态，常见值包括 queued、running、succeeded、failed。

content

object

error

object

查询视频生成任务豆包官方兼容查询视频任务

开始使用

图片和视频

AI 工具接入

API Reference

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

请求格式

Seedance 2.0 要点

查询任务

Authorizations

Body

Response