模型简介

Doubao‑Seedance‑1.x‑pro 系列是火山方舟豆包视频生成模型，支持文生视频、图生视频‑首帧、图生视频‑首尾帧能力。

• Doubao‑Seedance‑1.5‑pro：支持 draft 样片预览模式；支持返回视频尾帧；支持在线 / 离线两种推理服务等级；支持 heic/heif 图片格式输入。

• Doubao‑Seedance‑1.0‑pro：基础版本，支持文生视频、首帧图生视频、首尾帧图生视频；不支持自动音频生成、draft 样片模式。

调用流程

接口采用异步任务模式，分两步执行：

step1：调用创建任务接口，成功返回任务id

step2：调用查询任务接口查询对应任务id，直到status值为succeeded，获取生成视频url

创建任务接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/contents/generations/tasks

请求头

请求参数

content为文本的场景

content为图片的场景

content为样片信息的场景

响应参数

查询任务接口详情

http调用

请求方式：GET

请求路径：https://ai.ctaigw.cn/v1/contents/generations/tasks/

Path 路径参数

请求头

响应参数

请求/响应示例

创建任务请求示例

请求头

POST https://ai.ctaigw.cn/v1/contents/generations/tasks
Authorization: Bearer ${YOUR_APP_KEY}
Content-Type: application/json

文生视频请求示例

{
    "model": "doubao-seedance-1-5-pro",
    "content": [
        {
            "type": "text",
            "text": "春日森林，小鹿在林间漫步，柔和阳光穿过树叶，画面唯美治愈"
        }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 6
}

图生视频-首帧请求示例

{
    "model": "doubao-seedance-1-5-pro",
    "content": [
        {
            "type": "text",
            "text": "海面泛起层层浪花，海浪缓缓涌动"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://aaaa.ctyun.cn/001.jpg"
            },
            "role": "first_frame"
        }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 100,
    "return_last_frame": true
}

正常响应

{
  "id": "cgt-2026******-****"
}

异常响应

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

查询任务请求示例

请求

curl -X GET https://ai.ctaigw.cn/v1/contents/generations/tasks/{id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"

正常响应

{
    "id": "task‑xxxxxx",
    "model": "Doubao‑Seedance‑1.5‑pro",
    "status": "succeeded",
    "content": {
        "video_url": "https://aaaa.ctyun.cn/001.mp4",
        "last_frame_url": "https://aaaa.ctyun.cn/001.jpg"
    },
    "created_at": 1785678900,
    "updated_at": 1785679820,
    "draft": false,
    "duration": 5,
    "framespersecond": 24,
    "generate_audio": true,
    "ratio": "16:9",
    "resolution": "1280*720",
    "seed": 12345,
    "execution_expires_after": 3600,
    "usage": {
        "completion_tokens": 8500,
        "total_tokens": 8500
    }
}