主题
创建任务
POST
https://az.gptplus5.com/volc/v1/contents/generations/tasks
官方文档:https://www.volcengine.com/docs/82379/1520757
请求参数
Authorization
在 Header 添加参数Authorization,其值为在 Bearer 之后拼接 Token
示例:Authorization: Bearer ********************
Header 参数
| 参数名 | 类型 | 必需 | 说明 | 示例 |
|---|---|---|---|---|
Content-Type | string | 可选 | application/json | |
Accept | string | 可选 | application/json | |
Authorization | string | 可选 | Bearer {{YOUR_API_KEY}} |
Body 参数 (application/json)
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
model | string | 必需 | doubao-seedance-1-5-pro-251215 支持:文生、首帧、首尾帧 doubao-seedance-1-0-pro-250528 支持:文生、首帧、首尾帧 doubao-seedance-1-0-pro-fast-251015 支持:文生、首帧 doubao-seedance-1-0-lite-t2v-250428 支持:文生 doubao-seedance-1-0-lite-i2v-250428 支持:首帧、首尾帧、参考图(1-4) |
content | array[object] | 必需 | 输入给模型,生成视频的信息,支持文本信息和图片信息。 |
└ type | string | 必需 | 输入内容的类型: text 表示文本 image_url 表示图片 |
└ text | string | 必需 | 输入给模型的文本内容,描述期望生成的视频,包括: 文本提示词(必填):支持中英文。建议不超过500字。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成视频缺失部分元素。 |
└ image_url | object | 可选 | 输入给模型的图片对象。 |
└ role | string | 可选 | 图片用途: reference_image 表示参考图 first_frame 表示首帧 只为首帧的时候该参数可不填 last_frame 表示尾帧 |
generate_audio | boolean | 可选 | 控制生成的视频是否包含与画面同步的声音。 true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。” false:模型输出的视频为无声视频。 注意:该参数只支持 Seedance 1.5 pro 模型 默认值:true |
-- 参数 | object | 可选 | 以下参数需要添加到提示词后面 通过 -- 形式追加,参考示例 |
└ resolution | string | 可选 | 视频分辨率,枚举值: 480p 720p 1080p:参考图场景不支持 Seedance 1.5 pro、Seedance 1.0 lite 默认值:720p Seedance 1.0 pro & pro-fast 默认值:1080p |
└ ratio | string | 可选 | 生成视频的宽高比例: 16:9 4:3 1:1 3:4 9:16 21:9 文生视频:默认值 16:9( Seedance 1.5 Pro 默认为 自适应) 图生视频:默认 自适应(参考图生视频场景默认值为 16:9) |
└ duration | integer | 可选 | 生成视频时长,单位:秒。支持 2-12 秒 Seedance 1.5 pro 只支持 4-12 秒 默认值 5 |
└ camera_fixed | string | 可选 | 是否固定摄像头。枚举值: true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。 false:不固定摄像头。 注意:参考图场景不支 默认值 false |
└ watermark | string | 可选 | 生成视频是否包含水印。枚举值: false:不含水印。 true:含有水印。 默认值 false |
└ seed | integer | 可选 | 种子整数,用于控制生成内容的随机性。 取值范围:[-1, 2^32-1]之间的整数。 注意: 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。 默认值 -1 传入时不能输入 -1 |
请求示例
json
{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}cURL 示例
bash
curl --location --request POST 'https://az.gptplus5.com/volc/v1/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}'返回响应
🟢200成功
响应示例
json
{
"id": "cgt-20250918165243-bfpzb",
"status": "submitted"
}