创建视频生成任务API

本文将介绍慧星云创建视频生成任务 API 接口的使用。

POST /api.huixingyun.com/v1/videos

使用 Bearer token 方式进行 API 鉴权，格式为 Bearer 加上 API Key。Curl 请求中 HTTP Auth 头示例：--header 'Authorization: Bearer sk-xxxxxxxxxxxxxx' \

Body

名称	类型	是否必填	说明
model	string	是	模型id
content	object	是	输入给模型，生成视频的信息，支持文本信息和图片信息。
content.type	string	是	输入内容的类型，`text` 或者 `image`
content.text	string	是	输入给模型的文本内容，描述期望生成的视频，包括：
content.image_url	object	是	支持图片URL或图片 Base64 编码。图片URL：请确保图片URL可被访问。Base64编码：请遵循此格式data:image/<图片格式>;base64,<Base64编码>，注意 <图片格式> 需小写，如 data:image/png;base64,{base64_image}。传入图片需要满足以下条件：图片格式：jpeg、png、webp、bmp、tiff、gif。宽高比（宽/高）：在范围 (0.4, 2.5) 。宽高长度（px）：(300, 6000)。大小：小于30MB。
content.role	string	条件必填	图片的位置或用途。图生视频-首帧模型：doubao-seedance-pro、doubao-seedance-pro-fast、doubao-seedance-lite-i2vrole取值：不填，或`first_frame`图生视频-首尾帧模型：doubao-seedance-pro、doubao-seedance-lite-i2vrole取值：必填，首帧：`first_frame`；尾帧：`last_frame`传入的首尾帧图片可相同。首尾帧图片的宽高比不一致时，以首帧图片为主，尾帧图片会自动裁剪适配。图生视频-参考图模型：doubao-seedance-lite-i2vrole取值：必填，取值`reference_image`
callback_url	string		填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，将向此地址推送 POST 请求。回调返回的 status 包括以下状态：queued：排队中。running：任务运行中。succeeded：任务成功。（如发送失败，即5秒内没有接收到成功发送的信息，回调三次）failed：任务失败。（如发送失败，即5秒内没有接收到成功发送的信息，回调三次）

在文本提示词后追加 --[parameters] ，控制视频输出的规格，包括宽高比、帧率、分辨率等。不同模型，可能对应支持不同的参数与取值，详见输出视频格式。当输入的参数或取值不符合所选的模型时，内容会被忽略或报错。

// 指定生成视频的宽高比为16:9，时长为 5 秒，帧率为 24 fps，分辨率为720p，包含水印，种子整数为11，不固定摄像头

//参数使用简写
"content": [
        {
            "type": "text",
            "text": "女孩抱着狐狸 --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        }
    ]
    
//参数使用全称
"content": [
        {
            "type": "text",
            "text": "女孩抱着狐狸 --resolution 720p --ratio 16:9 --duration 5 --framespersecond 24 --watermark true --seed 11 --camerafixed false"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        }
    ]

名称	类型	简写	说明
resolution	string	rs	视频分辨率，枚举值：480p720p1080p：参考图场景不支持doubao-seedance-1-0-lite 默认值：720pdoubao-seedance-1-0-pro&pro-fast 默认值：1080p
ratio	string	rt	生成视频的宽高比例16:9 4:31:13:49:1621:9adaptive：仅图生视频支持。根据所上传图片的比例，自动选择最合适的宽高比。文生视频默认值是16:9图生视频默认值一般是adaptive。特别注意，参考图生视频的默认值是16:9
duration	integer	dur	生成视频时长，单位：秒。支持 2~12 秒。duration 和 frames 二选一即可，frames 的优先级高于 duration。如果您希望生成整数秒的视频，建议指定 duration。
frames	integer	frames	生成视频的帧数。通过指定帧数，可以灵活控制生成视频的长度，生成小数秒的视频。由于 frames 的取值限制，仅能支持有限小数秒，您需要根据公式推算最接近的帧数。计算公式：帧数 = 时长 × 帧率（24）。取值范围：支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值，其中 n 为正整数。例如：假设需要生成 2.4 秒的视频，帧数=2.4×24=57.6。由于 frames 不支持 57.6，此时您只能选择一个最接近的值。根据 25+4n 计算出最接近的帧数为 57，实际生成的视频为 57/24=2.375 秒。duration 和 frames 二选一即可，frames 的优先级高于 duration。如果您希望生成小数秒的视频，建议指定 frames。
framespersecond	integer	fps	帧率，即一秒时间内视频画面数量。仅支持 24
seed	integer	seed	种子整数，用于控制生成内容的随机性。取值范围：[-1, 2^32-1]之间的整数。默认值 -1。
camerafixed	boolean	cf	是否固定摄像头。枚举值：true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。false：不固定摄像头。参考图场景不支持，默认值-1
watermark	boolean	wm	生成视频是否包含水印。枚举值：false：不含水印。true：含有水印。默认值 false。

Body

名称	类型	说明
id	string	视频生成任务 ID 。创建视频生成任务为异步接口，获取 ID 后，需要通过查询视频生成任务 API 来查询视频生成任务的状态。任务成功后，会输出生成视频的video_url。

curl -X POST https://api.huixingyun.com/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
        {
            "type": "text",
            "text": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索，手里拿起桌上的某个物品。镜头转向他正在思索。 --ratio 16:9"
        }
    ]
}'

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

curl -X POST https://api.huixingyun.com/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
     "model": "doubao-seedance-1-0-pro-fast-251015",
    "content": [
        {
            "type": "text",
            "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动  --ratio adaptive  --dur 5"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        }
    ]
}'

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

curl -X POST https://api.huixingyun.com/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
         {
            "type": "text",
            "text": "360度环绕运镜"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
            },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
            },
            "role": "last_frame"
        }
    ]
}'

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

curl -X POST https://api.huixingyun.com/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "content": [
         {
            "type": "text",
            "text": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，3D卡通风格"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png"
            },
            "role": "reference_image"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png"
            },
            "role": "reference_image"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
            },
            "role": "reference_image"
        }
    ]
}'

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

curl -X POST https://api.huixingyun.com/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "content": [
        {
            "type": "text",
            "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动  --ratio adaptive  --dur 5"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,aHR0******cG5n"
            }
        }
    ]
}'

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

curl -X POST https://api.huixingyun.com/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "content": [
        {
            "type": "text",
            "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠。 --ratio 16:9"
        }
    ],
    "callback_url": "https://****"
}'

//以下为向您的 callback_url 发送的请求体

// 状态为queued时：
{
    "id": "cgt-2025******-****",
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "status": "queued",
    "created_at": 1745899232,
    "updated_at": 1745899232
}

//状态为running时：
{
    "id": "cgt-2025******-****",
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "status": "running",
    "created_at": 1745910851,
    "updated_at": 1745910851
}

//状态为succeeded时：
{
  "id": "cgt-2025******-****",
  "model": "doubao-seedance-1-0-lite-t2v-250428",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/****"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1743414619,
  "updated_at": 1743414673
}

2025-12-17

创建视频生成任务API

鉴权

请求

模型文本命令

响应

调用示例

文生视频

图生视频-首帧

图生视频-首尾帧

图生视频-参考图

图生视频-base64编码

callback使用示例

本页目录