# Seedance文生视频

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

统一接口格式

## 请求参数

### Header 参数

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

### Body 参数 application/json

```text
prompt
string
必需
文本提示词（必填）：支持中英文。建议不超过500字。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视频缺失部分元素
model
enum<string>
必需
型号名称。示例：doubao-seedance-1-0-pro-250528
枚举值:
doubao-seedance-1-0-pro-250528
最新机型
文生视频 图生视频-基于首帧
doubao-seedance-1-0-lite-t2v-250428
文生视频
doubao-seedance-1-0-lite-i2v-250428
图生视频-首帧 图生视频-首尾帧 图生视频-参考图
duration
enum<integer>
可选
生成视频的持续时间（以秒为单位）。该参数固定为 5，无法修改。模型始终生成一个 5 秒的视频。
枚举值:
5
10
默认值:
5
resolution
enum<string>
视频分辨率
可选
枚举值:
480p
720p
1080p
默认值:
480p
ratio
string
可选
生成视频的宽高比例
21:9
16:9
4:3
1:1
3:4
9:16
9:21
keep_ratio：所生成视频的宽高比与所上传图片的宽高比保持一致。
adaptive：根据所上传图片的比例，自动选择最合适的宽高比。
默认值:
16:9
watermark
boolean
可选
指定是否添加水印。水印位于视频的右下角，注明“由人工智能生成”。
默认值:
false
seed
integer
可选
一个随机数种子，用于控制模型生成的内容的随机性。该值必须在 [0， 2147483647] 的范围内。
如果不提供此参数，则算法会自动为种子生成一个随机数。如果希望生成的内容保持相对稳定，可以使用相同的种子值。
camerafixed
boolean
可选
是否固定摄像头
true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。
false：不固定摄像头。
默认值:
false
return_last_frame
boolean
可选
true：返回生成视频的尾帧图像。尾帧图像的格式为 png，宽高像素值与生成的视频一致，无水印。您可通过查询视频生成任务接口获取视频的尾帧图像。
false：不返回生成视频的尾帧图像。
默认值:
false
generate_audio
boolean
可选
示例
{
"prompt"
:
"dance"
,
"model"
:
"doubao-seedance-1-0-lite-t2v-250428"
}
```

## 请求示例代码

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

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
task_id
string
必需
```

#### 示例

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