官方文档：https://www.volcengine.com/docs/82379/1520757
POST
/volc/v1/contents/generations/tasks创建任务
API Key application/json
请求示例
curl -X POST https://top.qingyuntop.ai/volc/v1/contents/generations/tasks \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"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"
}
]
}'请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Content-Type | Header | string | 否 | - | application/json |
Accept | Header | string | 否 | - | application/json |
Authorization | Header | string | 否 | - | Bearer {{YOUR_API_KEY}} |
model | JSON body | 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 | JSON body | array<object> | 是 | 输入给模型，生成视频的信息，支持文本信息和图片信息。 | - |
content[].type | JSON body | string | 是 | 输入内容的类型： - text 表示文本 - image_url 表示图片 | - |
content[].text | JSON body | string | 是 | 输入给模型的文本内容，描述期望生成的视频，包括： 文本提示词（必填）：支持中英文。建议不超过500字。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视频缺失部分元素。 | - |
content[].image_url | JSON body | object | 否 | 输入给模型的图片对象。 | - |
content[].image_url.url | JSON body | string | 否 | 图片信息，这里为图片url 或 Base64 编码。 | - |
content[].role | JSON body | string | 否 | 图片用途： - reference_image 表示参考图 - first_frame 表示首帧 只为首帧的时候该参数可不填 - last_frame 表示尾帧 | - |
generate_audio | JSON body | boolean | 否 | 控制生成的视频是否包含与画面同步的声音。 - true：模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容，自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内，以优化音频生成效果。例如：男人叫住女人说：“你记住，以后不可以用手指指月亮。” - false：模型输出的视频为无声视频。 注意：该参数只支持 Seedance 1.5 pro 模型 默认值：true | - |
-- 参数 | JSON body | object | 否 | 以下参数需要添加到提示词后面 通过 -- 形式追加，参考示例 | - |
-- 参数.resolution | JSON body | string | 否 | 视频分辨率，枚举值： - 480p - 720p - 1080p：参考图场景不支持 Seedance 1.5 pro、Seedance 1.0 lite 默认值：720p Seedance 1.0 pro & pro-fast 默认值：1080p | - |
-- 参数.ratio | JSON body | string | 否 | 生成视频的宽高比例： - 16:9 - 4:3 - 1:1 - 3:4 - 9:16 - 21:9 文生视频：默认值 16:9（ Seedance 1.5 Pro 默认为 自适应） 图生视频：默认 自适应（参考图生视频场景默认值为 16:9） | - |
-- 参数.duration | JSON body | integer | 否 | 生成视频时长，单位：秒。支持 2-12 秒 Seedance 1.5 pro 只支持 4-12 秒 默认值 5 | - |
-- 参数.camera_fixed | JSON body | string | 否 | 是否固定摄像头。枚举值： - true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。 - false：不固定摄像头。 注意：参考图场景不支 默认值 false | - |
-- 参数.watermark | JSON body | string | 否 | 生成视频是否包含水印。枚举值： - false：不含水印。 - true：含有水印。 默认值 false | - |
-- 参数.seed | JSON body | integer | 否 | 种子整数，用于控制生成内容的随机性。 取值范围：[-1, 2^32-1]之间的整数。 注意： - 相同的请求下，模型收到不同的seed值，如：不指定seed值或令seed取值为-1（会使用随机数替代）、或手动变更seed值，将生成不同的结果。 - 相同的请求下，模型收到相同的seed值，会生成类似的结果，但不保证完全一致。 默认值 -1 传入时不能输入 -1 | - |
返回响应 (200)
此部分没有定义参数。
响应示例
{
"id": "cgt-20250918165243-bfpzb",
"status": "submitted"
}来源原始接口定义（用于追溯）
以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899712,
"name": "创建任务",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "官方文档：https://www.volcengine.com/docs/82379/1520757",
"operationId": "",
"sourceUrl": "",
"method": "post",
"path": "/volc/v1/contents/generations/tasks",
"tags": [],
"status": 1,
"requestBody": {
"type": "application/json",
"parameters": [],
"jsonSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "doubao-seedance-1-5-pro-251215 支持：文生、首帧、首尾帧\ndoubao-seedance-1-0-pro-250528 支持：文生、首帧、首尾帧\ndoubao-seedance-1-0-pro-fast-251015 支持：文生、首帧\ndoubao-seedance-1-0-lite-t2v-250428 支持：文生\ndoubao-seedance-1-0-lite-i2v-250428 支持：首帧、首尾帧、参考图（1-4）"
},
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "输入内容的类型：\n- text 表示文本\n- image_url 表示图片"
},
"text": {
"type": "string",
"description": "输入给模型的文本内容，描述期望生成的视频，包括：\n文本提示词（必填）：支持中英文。建议不超过500字。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视频缺失部分元素。"
},
"image_url": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "图片信息，这里为图片url 或 Base64 编码。"
}
},
"x-apifox-orders": [
"url"
],
"description": "输入给模型的图片对象。"
},
"role": {
"type": "string",
"description": "图片用途：\n- reference_image 表示参考图\n- first_frame 表示首帧 只为首帧的时候该参数可不填\n- last_frame 表示尾帧"
}
},
"x-apifox-orders": [
"type",
"text",
"image_url",
"role"
],
"required": [
"type",
"text"
]
},
"description": "输入给模型，生成视频的信息，支持文本信息和图片信息。"
},
"-- 参数": {
"type": "object",
"properties": {
"resolution": {
"type": "string",
"description": "视频分辨率，枚举值：\n- 480p\n- 720p\n- 1080p：参考图场景不支持\n\nSeedance 1.5 pro、Seedance 1.0 lite 默认值：720p\nSeedance 1.0 pro & pro-fast 默认值：1080p"
},
"ratio": {
"type": "string",
"description": "生成视频的宽高比例：\n- 16:9 \n- 4:3\n- 1:1\n- 3:4\n- 9:16\n- 21:9\n\n文生视频：默认值 16:9（ Seedance 1.5 Pro 默认为 自适应）\n图生视频：默认 自适应（参考图生视频场景默认值为 16:9）"
},
"camera_fixed": {
"type": "string",
"description": "是否固定摄像头。枚举值：\n- true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。\n- false：不固定摄像头。\n\n注意：参考图场景不支\n默认值 false"
},
"watermark": {
"type": "string",
"description": "生成视频是否包含水印。枚举值：\n- false：不含水印。\n- true：含有水印。\n\n默认值 false"
},
"duration": {
"type": "integer",
"description": "生成视频时长，单位：秒。支持 2-12 秒\nSeedance 1.5 pro 只支持 4-12 秒\n默认值 5"
},
"seed": {
"type": "integer",
"description": "种子整数，用于控制生成内容的随机性。\n取值范围：[-1, 2^32-1]之间的整数。\n注意：\n- 相同的请求下，模型收到不同的seed值，如：不指定seed值或令seed取值为-1（会使用随机数替代）、或手动变更seed值，将生成不同的结果。\n- 相同的请求下，模型收到相同的seed值，会生成类似的结果，但不保证完全一致。\n\n默认值 -1 传入时不能输入 -1"
}
},
"x-apifox-orders": [
"resolution",
"ratio",
"duration",
"camera_fixed",
"watermark",
"seed"
],
"description": "以下参数需要添加到提示词后面 通过 -- 形式追加，参考示例"
},
"generate_audio": {
"type": "boolean",
"description": "控制生成的视频是否包含与画面同步的声音。\n- true：模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容，自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内，以优化音频生成效果。例如：男人叫住女人说：“你记住，以后不可以用手指指月亮。”\n- false：模型输出的视频为无声视频。\n\n注意：该参数只支持 Seedance 1.5 pro 模型\n默认值：true"
}
},
"required": [
"model",
"content"
],
"x-apifox-orders": [
"model",
"content",
"generate_audio",
"-- 参数"
]
},
"examples": [
{
"value": "{\r\n \"model\": \"doubao-seedance-1-0-pro-fast-251015\",\r\n \"content\": [\r\n {\r\n \"type\": \"text\",\r\n \"text\": \"写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1\"\r\n }\r\n ]\r\n}",
"mediaType": "application/json",
"description": "",
"name": "文生视频"
},
{
"name": "图生视频-首帧",
"value": "{\r\n \"model\": \"doubao-seedance-1-0-lite-i2v-250428\",\r\n \"content\": [\r\n {\r\n \"type\": \"text\",\r\n \"text\": \"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png\"\r\n }\r\n }\r\n ]\r\n}",
"mediaType": "application/json"
},
{
"name": "图生视频-首尾帧",
"value": "{\r\n \"model\": \"doubao-seedance-1-0-pro-250528\",\r\n \"content\": [\r\n {\r\n \"type\": \"text\",\r\n \"text\": \"图中女孩对着镜头说“茄子”，360度环绕运镜 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg\"\r\n },\r\n \"role\": \"first_frame\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg\"\r\n },\r\n \"role\": \"last_frame\"\r\n }\r\n ]\r\n}",
"mediaType": "application/json"
},
{
"name": "图生视频-参考图",
"value": "{\r\n \"model\": \"doubao-seedance-1-0-lite-i2v-250428\",\r\n \"content\": [\r\n {\r\n \"type\": \"text\",\r\n \"text\": \"[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，3D卡通风格 --resolution 720p --ratio 16:9 --duration 12 --watermark false --seed 1\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png\"\r\n },\r\n \"role\": \"reference_image\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png\"\r\n },\r\n \"role\": \"reference_image\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png\"\r\n },\r\n \"role\": \"reference_image\"\r\n }\r\n ]\r\n}",
"mediaType": "application/json"
},
{
"name": "图生视频-base64编码",
"value": "{\r\n \"model\": \"doubao-seedance-1-0-lite-i2v-250428\",\r\n \"content\": [\r\n {\r\n \"type\": \"text\",\r\n \"text\": \"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1\"\r\n },\r\n {\r\n \"type\": \"image_url\",\r\n \"image_url\": {\r\n \"url\": \"data:image/png;base64,aHR0******cG5n\"\r\n }\r\n }\r\n ]\r\n}",
"mediaType": "application/json"
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [],
"cookie": [],
"header": [
{
"id": "mbXak4UT7M",
"name": "Content-Type",
"required": false,
"enable": false,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "2Is2sicmWA",
"name": "Accept",
"required": false,
"enable": false,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "nDXV3kC5ty",
"name": "Authorization",
"required": false,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "Bearer {{YOUR_API_KEY}}"
}
]
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {},
"responses": [
{
"id": 132624949,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {},
"x-apifox-orders": []
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": []
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 132624949,
"data": "{\r\n \"id\": \"cgt-20250918165243-bfpzb\",\r\n \"status\": \"submitted\"\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b1d-71aa-a555-ec6e3cce8737"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436122,
"ordering": 0,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {}
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-06T12:15:55.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}