Skip to content
EN

Seedance首尾帧图生视频

方法: POST路径: /v2/videos/generations

统一接口格式

请求参数

Header 参数

text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

text
prompt
string
必需
The text prompt supports Chinese and English, with a maximum length of 800 characters. Each Chinese character or letter counts as one character. Content that exceeds this limit will be truncated.
文本提示支持中英文,最大长度为800个字符。每个汉字或字母算作一个字符。超过此限制的内容将被截断。
Example: A kitten running in the moonlight.
示例:一只小猫在月光下奔跑。
model
enum<string>
必需
型号名称。示例:doubao-seedance-1-0-pro-250528
值:
doubao-seedance-1-0-lite-i2v-250428
图生视频-首帧 图生视频-首尾帧 图生视频-参考图
images
array
[string]
参考图
必需
duration
enum<integer>
可选
生成视频的持续时间(以秒为单位)。该参数固定为 5,无法修改。模型始终生成一个 5 秒的视频。
枚举值:
5
10
resolution
enum<string>
视频分辨率
可选
枚举值:
480p
720p
1080p
ratio
string
可选
生成视频的宽高比例
21:9
16:9
4:3
1:1
3:4
9:16
9:21
keep_ratio:所生成视频的宽高比与所上传图片的宽高比保持一致。
adaptive:根据所上传图片的比例,自动选择最合适的宽高比。
watermark
boolean
可选
指定是否添加水印。水印位于视频的右下角,注明“由人工智能生成”。
seed
integer
可选
一个随机数种子,用于控制模型生成的内容的随机性。该值必须在 [0, 2147483647] 的范围内。
如果不提供此参数,则算法会自动为种子生成一个随机数。如果希望生成的内容保持相对稳定,可以使用相同的种子值。
camerafixed
boolean
可选
是否固定摄像头
true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。
false:不固定摄像头。
return_last_frame
boolean
可选
仅doubao-seedance-1-0-lite-i2v支持该参
true:返回生成视频的尾帧图像。尾帧图像的格式为 png,宽高像素值与生成的视频一致,无水印。您可通过查询视频生成任务接口获取视频的尾帧图像。
false:不返回生成视频的尾帧图像。
generate_audio
boolean
可选
示例
{
"prompt"
:
"dance"
,
"model"
:
"doubao-seedance-1-0-lite-i2v-250428"
,
"images"
:
[
"https://webstatic.aiproxy.vip/dist/demo.jpg"
,
"https://webstatic.aiproxy.vip/dist/demo.jpg"
]
}

请求示例代码

Shell

bash
curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "dance",
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "images": [
        "https://webstatic.aiproxy.vip/dist/demo.jpg",
        "https://webstatic.aiproxy.vip/dist/demo.jpg"
    ]
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

text
task_id
string
必需

示例

json
{
    "task_id": "cgt-20250831141439-sqmgf"
}