# 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"
}
```