1. 豆包 Volc
梧柏API使用文档
WHBAI · 豆包 Volc
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 豆包 Volc
    • 创建视频生成任务
      POST
    • 查询任务列表
      GET
    • 查询单个任务
      GET
    • 取消任务
      DELETE
  • Seedance 2.0 · api
    • v3
      • 创建视频生成任务 API(doubao-2.0)
      • doubao-2.0 查询视频生成任务列表
      • doubao-2.0 查询视频生成任务 API
  • volc
    • Seedream 5.0 Pro
      POST
  • 数据模型
    • VolcSampleRequest
    • VolcSampleResponse
    • PostApiV3ContentsGenerationsTasksRequest
    • GetApiV3ContentsGenerationsTasksIdResponse
    • NewApiError
  1. 豆包 Volc

创建视频生成任务

POST
/volc/v1/contents/generations/tasks
提交 Seedance/豆包视频生成任务。

网站中的模型与调用示例#

创建任务#

官方文档:https://www.volcengine.com/docs/82379/1520757

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "-- 参数": {
      "description": "以下参数需要添加到提示词后面  通过 -- 形式追加,参考示例",
      "properties": {
        "camera_fixed": {
          "description": "是否固定摄像头。枚举值:\n- true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。\n- false:不固定摄像头。\n\n注意:参考图场景不支\n默认值 false",
          "type": "string"
        },
        "duration": {
          "description": "生成视频时长,单位:秒。支持 2-12 秒\nSeedance 1.5 pro 只支持 4-12 秒\n默认值 5",
          "type": "integer"
        },
        "ratio": {
          "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)",
          "type": "string"
        },
        "resolution": {
          "description": "视频分辨率,枚举值:\n- 480p\n- 720p\n- 1080p:参考图场景不支持\n\nSeedance 1.5 pro、Seedance 1.0 lite 默认值:720p\nSeedance 1.0 pro & pro-fast 默认值:1080p",
          "type": "string"
        },
        "seed": {
          "description": "种子整数,用于控制生成内容的随机性。\n取值范围:[-1, 2^32-1]之间的整数。\n注意:\n- 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。\n- 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。\n\n默认值 -1  传入时不能输入 -1",
          "type": "integer"
        },
        "watermark": {
          "description": "生成视频是否包含水印。枚举值:\n- false:不含水印。\n- true:含有水印。\n\n默认值 false",
          "type": "string"
        }
      },
      "type": "object"
    },
    "content": {
      "description": "输入给模型,生成视频的信息,支持文本信息和图片信息。",
      "items": {
        "properties": {
          "image_url": {
            "description": "输入给模型的图片对象。",
            "properties": {
              "url": {
                "description": "图片信息,这里为图片url 或 Base64 编码。",
                "type": "string"
              }
            },
            "type": "object"
          },
          "role": {
            "description": "图片用途:\n- reference_image 表示参考图\n- first_frame 表示首帧  只为首帧的时候该参数可不填\n- last_frame 表示尾帧",
            "type": "string"
          },
          "text": {
            "description": "输入给模型的文本内容,描述期望生成的视频,包括:\n文本提示词(必填):支持中英文。建议不超过500字。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成视频缺失部分元素。",
            "type": "string"
          },
          "type": {
            "description": "输入内容的类型:\n- text 表示文本\n- image_url 表示图片",
            "type": "string"
          }
        },
        "required": [
          "type",
          "text"
        ],
        "type": "object"
      },
      "type": "array",
      "x-i18n": {
        "en-US": {
          "description": "Input for the model to generate video. Supports text and image content."
        }
      }
    },
    "generate_audio": {
      "description": "控制生成的视频是否包含与画面同步的声音。\n- true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。”\n- false:模型输出的视频为无声视频。\n\n注意:该参数只支持 Seedance 1.5 pro 模型\n默认值:true",
      "type": "boolean"
    },
    "model": {
      "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)",
      "type": "string"
    }
  },
  "required": [
    "model",
    "content"
  ]
}

请求示例 · 文生视频#

{
  "content": [
    {
      "text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    }
  ],
  "model": "doubao-seedance-1-0-pro-fast-251015"
}

请求示例 · 图生视频-首帧#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-pro-250528"
}

请求示例 · 图生视频-参考图#

{
  "content": [
    {
      "text": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗,坐在[图3]的草坪上,3D卡通风格 --resolution 720p --ratio 16:9 --duration 12 --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
      },
      "role": "reference_image",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-base64编码#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "data:image/png;base64,aHR0******cG5n"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · seedance-1-5-pro-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --dur 5",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-5-pro-251215"
}

请求示例 · seedance-1-5-pro#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "duration": 4,
  "model": "doubao-seedance-1-5-pro-251215",
  "ratio": "adaptive",
  "watermark": false
}

响应示例 · 成功示例#

{
  "id": "cgt-20250918165243-bfpzb",
  "status": "submitted"
}

创建任务#

官方文档:https://www.volcengine.com/docs/82379/1520757

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "-- 参数": {
      "description": "以下参数需要添加到提示词后面  通过 -- 形式追加,参考示例",
      "properties": {
        "camera_fixed": {
          "description": "是否固定摄像头。枚举值:\n- true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。\n- false:不固定摄像头。\n\n注意:参考图场景不支\n默认值 false",
          "type": "string"
        },
        "duration": {
          "description": "生成视频时长,单位:秒。支持 2-12 秒\nSeedance 1.5 pro 只支持 4-12 秒\n默认值 5",
          "type": "integer"
        },
        "ratio": {
          "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)",
          "type": "string"
        },
        "resolution": {
          "description": "视频分辨率,枚举值:\n- 480p\n- 720p\n- 1080p:参考图场景不支持\n\nSeedance 1.5 pro、Seedance 1.0 lite 默认值:720p\nSeedance 1.0 pro & pro-fast 默认值:1080p",
          "type": "string"
        },
        "seed": {
          "description": "种子整数,用于控制生成内容的随机性。\n取值范围:[-1, 2^32-1]之间的整数。\n注意:\n- 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。\n- 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。\n\n默认值 -1  传入时不能输入 -1",
          "type": "integer"
        },
        "watermark": {
          "description": "生成视频是否包含水印。枚举值:\n- false:不含水印。\n- true:含有水印。\n\n默认值 false",
          "type": "string"
        }
      },
      "type": "object"
    },
    "content": {
      "description": "输入给模型,生成视频的信息,支持文本信息和图片信息。",
      "items": {
        "properties": {
          "image_url": {
            "description": "输入给模型的图片对象。",
            "properties": {
              "url": {
                "description": "图片信息,这里为图片url 或 Base64 编码。",
                "type": "string"
              }
            },
            "type": "object"
          },
          "role": {
            "description": "图片用途:\n- reference_image 表示参考图\n- first_frame 表示首帧  只为首帧的时候该参数可不填\n- last_frame 表示尾帧",
            "type": "string"
          },
          "text": {
            "description": "输入给模型的文本内容,描述期望生成的视频,包括:\n文本提示词(必填):支持中英文。建议不超过500字。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成视频缺失部分元素。",
            "type": "string"
          },
          "type": {
            "description": "输入内容的类型:\n- text 表示文本\n- image_url 表示图片",
            "type": "string"
          }
        },
        "required": [
          "type",
          "text"
        ],
        "type": "object"
      },
      "type": "array",
      "x-i18n": {
        "en-US": {
          "description": "Input for the model to generate video. Supports text and image content."
        }
      }
    },
    "generate_audio": {
      "description": "控制生成的视频是否包含与画面同步的声音。\n- true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。”\n- false:模型输出的视频为无声视频。\n\n注意:该参数只支持 Seedance 1.5 pro 模型\n默认值:true",
      "type": "boolean"
    },
    "model": {
      "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)",
      "type": "string"
    }
  },
  "required": [
    "model",
    "content"
  ]
}

请求示例 · 文生视频#

{
  "content": [
    {
      "text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    }
  ],
  "model": "doubao-seedance-1-0-pro-fast-251015"
}

请求示例 · 图生视频-首帧#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-pro-250528"
}

请求示例 · 图生视频-参考图#

{
  "content": [
    {
      "text": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗,坐在[图3]的草坪上,3D卡通风格 --resolution 720p --ratio 16:9 --duration 12 --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
      },
      "role": "reference_image",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-base64编码#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "data:image/png;base64,aHR0******cG5n"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · seedance-1-5-pro-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --dur 5",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-5-pro-251215"
}

请求示例 · seedance-1-5-pro#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "duration": 4,
  "model": "doubao-seedance-1-5-pro-251215",
  "ratio": "adaptive",
  "watermark": false
}

响应示例 · 成功示例#

{
  "id": "cgt-20250918165243-bfpzb",
  "status": "submitted"
}

创建任务#

官方文档:https://www.volcengine.com/docs/82379/1520757

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "-- 参数": {
      "description": "以下参数需要添加到提示词后面  通过 -- 形式追加,参考示例",
      "properties": {
        "camera_fixed": {
          "description": "是否固定摄像头。枚举值:\n- true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。\n- false:不固定摄像头。\n\n注意:参考图场景不支\n默认值 false",
          "type": "string"
        },
        "duration": {
          "description": "生成视频时长,单位:秒。支持 2-12 秒\nSeedance 1.5 pro 只支持 4-12 秒\n默认值 5",
          "type": "integer"
        },
        "ratio": {
          "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)",
          "type": "string"
        },
        "resolution": {
          "description": "视频分辨率,枚举值:\n- 480p\n- 720p\n- 1080p:参考图场景不支持\n\nSeedance 1.5 pro、Seedance 1.0 lite 默认值:720p\nSeedance 1.0 pro & pro-fast 默认值:1080p",
          "type": "string"
        },
        "seed": {
          "description": "种子整数,用于控制生成内容的随机性。\n取值范围:[-1, 2^32-1]之间的整数。\n注意:\n- 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。\n- 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。\n\n默认值 -1  传入时不能输入 -1",
          "type": "integer"
        },
        "watermark": {
          "description": "生成视频是否包含水印。枚举值:\n- false:不含水印。\n- true:含有水印。\n\n默认值 false",
          "type": "string"
        }
      },
      "type": "object"
    },
    "content": {
      "description": "输入给模型,生成视频的信息,支持文本信息和图片信息。",
      "items": {
        "properties": {
          "image_url": {
            "description": "输入给模型的图片对象。",
            "properties": {
              "url": {
                "description": "图片信息,这里为图片url 或 Base64 编码。",
                "type": "string"
              }
            },
            "type": "object"
          },
          "role": {
            "description": "图片用途:\n- reference_image 表示参考图\n- first_frame 表示首帧  只为首帧的时候该参数可不填\n- last_frame 表示尾帧",
            "type": "string"
          },
          "text": {
            "description": "输入给模型的文本内容,描述期望生成的视频,包括:\n文本提示词(必填):支持中英文。建议不超过500字。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成视频缺失部分元素。",
            "type": "string"
          },
          "type": {
            "description": "输入内容的类型:\n- text 表示文本\n- image_url 表示图片",
            "type": "string"
          }
        },
        "required": [
          "type",
          "text"
        ],
        "type": "object"
      },
      "type": "array",
      "x-i18n": {
        "en-US": {
          "description": "Input for the model to generate video. Supports text and image content."
        }
      }
    },
    "generate_audio": {
      "description": "控制生成的视频是否包含与画面同步的声音。\n- true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。”\n- false:模型输出的视频为无声视频。\n\n注意:该参数只支持 Seedance 1.5 pro 模型\n默认值:true",
      "type": "boolean"
    },
    "model": {
      "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)",
      "type": "string"
    }
  },
  "required": [
    "model",
    "content"
  ]
}

请求示例 · 文生视频#

{
  "content": [
    {
      "text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    }
  ],
  "model": "doubao-seedance-1-0-pro-fast-251015"
}

请求示例 · 图生视频-首帧#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-pro-250528"
}

请求示例 · 图生视频-参考图#

{
  "content": [
    {
      "text": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗,坐在[图3]的草坪上,3D卡通风格 --resolution 720p --ratio 16:9 --duration 12 --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
      },
      "role": "reference_image",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-base64编码#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "data:image/png;base64,aHR0******cG5n"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · seedance-1-5-pro-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --dur 5",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-5-pro-251215"
}

请求示例 · seedance-1-5-pro#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "duration": 4,
  "model": "doubao-seedance-1-5-pro-251215",
  "ratio": "adaptive",
  "watermark": false
}

响应示例 · 成功示例#

{
  "id": "cgt-20250918165243-bfpzb",
  "status": "submitted"
}

创建任务#

官方文档:https://www.volcengine.com/docs/82379/1520757

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "-- 参数": {
      "description": "以下参数需要添加到提示词后面  通过 -- 形式追加,参考示例",
      "properties": {
        "camera_fixed": {
          "description": "是否固定摄像头。枚举值:\n- true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。\n- false:不固定摄像头。\n\n注意:参考图场景不支\n默认值 false",
          "type": "string"
        },
        "duration": {
          "description": "生成视频时长,单位:秒。支持 2-12 秒\nSeedance 1.5 pro 只支持 4-12 秒\n默认值 5",
          "type": "integer"
        },
        "ratio": {
          "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)",
          "type": "string"
        },
        "resolution": {
          "description": "视频分辨率,枚举值:\n- 480p\n- 720p\n- 1080p:参考图场景不支持\n\nSeedance 1.5 pro、Seedance 1.0 lite 默认值:720p\nSeedance 1.0 pro & pro-fast 默认值:1080p",
          "type": "string"
        },
        "seed": {
          "description": "种子整数,用于控制生成内容的随机性。\n取值范围:[-1, 2^32-1]之间的整数。\n注意:\n- 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。\n- 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。\n\n默认值 -1  传入时不能输入 -1",
          "type": "integer"
        },
        "watermark": {
          "description": "生成视频是否包含水印。枚举值:\n- false:不含水印。\n- true:含有水印。\n\n默认值 false",
          "type": "string"
        }
      },
      "type": "object"
    },
    "content": {
      "description": "输入给模型,生成视频的信息,支持文本信息和图片信息。",
      "items": {
        "properties": {
          "image_url": {
            "description": "输入给模型的图片对象。",
            "properties": {
              "url": {
                "description": "图片信息,这里为图片url 或 Base64 编码。",
                "type": "string"
              }
            },
            "type": "object"
          },
          "role": {
            "description": "图片用途:\n- reference_image 表示参考图\n- first_frame 表示首帧  只为首帧的时候该参数可不填\n- last_frame 表示尾帧",
            "type": "string"
          },
          "text": {
            "description": "输入给模型的文本内容,描述期望生成的视频,包括:\n文本提示词(必填):支持中英文。建议不超过500字。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成视频缺失部分元素。",
            "type": "string"
          },
          "type": {
            "description": "输入内容的类型:\n- text 表示文本\n- image_url 表示图片",
            "type": "string"
          }
        },
        "required": [
          "type",
          "text"
        ],
        "type": "object"
      },
      "type": "array",
      "x-i18n": {
        "en-US": {
          "description": "Input for the model to generate video. Supports text and image content."
        }
      }
    },
    "generate_audio": {
      "description": "控制生成的视频是否包含与画面同步的声音。\n- true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。”\n- false:模型输出的视频为无声视频。\n\n注意:该参数只支持 Seedance 1.5 pro 模型\n默认值:true",
      "type": "boolean"
    },
    "model": {
      "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)",
      "type": "string"
    }
  },
  "required": [
    "model",
    "content"
  ]
}

请求示例 · 文生视频#

{
  "content": [
    {
      "text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    }
  ],
  "model": "doubao-seedance-1-0-pro-fast-251015"
}

请求示例 · 图生视频-首帧#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-pro-250528"
}

请求示例 · 图生视频-参考图#

{
  "content": [
    {
      "text": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗,坐在[图3]的草坪上,3D卡通风格 --resolution 720p --ratio 16:9 --duration 12 --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
      },
      "role": "reference_image",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · 图生视频-base64编码#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动 --resolution 1080p --ratio 16:9 --duration 12 --camera_fixed false --watermark false --seed 1",
      "type": "text"
    },
    {
      "image_url": {
        "url": "data:image/png;base64,aHR0******cG5n"
      },
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-0-lite-i2v-250428"
}

请求示例 · seedance-1-5-pro-首尾帧#

{
  "content": [
    {
      "text": "图中女孩对着镜头说“茄子”,360度环绕运镜 --dur 5",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "role": "first_frame",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "role": "last_frame",
      "type": "image_url"
    }
  ],
  "model": "doubao-seedance-1-5-pro-251215"
}

请求示例 · seedance-1-5-pro#

{
  "content": [
    {
      "text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "duration": 4,
  "model": "doubao-seedance-1-5-pro-251215",
  "ratio": "adaptive",
  "watermark": false
}

响应示例 · 成功示例#

{
  "id": "cgt-20250918165243-bfpzb",
  "status": "submitted"
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "一只猫在草地上奔跑"
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/volc/v1/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "一只猫在草地上奔跑"
        }
    ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "id": "cgt-20250918170228-dw9rb",
    "status": "submitted"
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:25
下一页
查询任务列表
Built with