跳到内容

Seedream ​

更新时间

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask

Seedream 是图片生成模型,支持文生图与多图参考生成(5.0-pro 最多 10 张参考图)。提供 5.5、5.0-flash、5.0-pro、5.0-lite、4.5、4.0 多个版本。最新的 5.5(2026-11-17 上线)与 5.0-flash(2026-11-12 上线)共用同一套参数,都支持图片分层。

版本规格差异见版本差异,各版本的调用写法见按版本调用。

基本信息 ​

项目取值
ModelNameSI(5.5 / 5.0-flash / 5.0-pro)/ Seedream(5.0-lite / 4.5 / 4.0)
ModelVersion5.5 / 5.0-flash / 5.0-pro / 5.0-lite / 4.5 / 4.0
原有 Seedream 默认值ModelVersion=4.0 / AspectRatio=1:1
支持解除护栏不支持

版本差异 ​

版本分辨率比例参考图片
5.5 / 5.0-flash1K / 1.5K / 2K / 4K(OutputConfig.Resolution)1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9支持(图生、图片分层)
5.0-pro1K / 1.5K / 2K 像素指定1:1 / 16:9 / 9:16 / 4:3 / 3:4最多 10 张
5.0-lite / 4.5 / 4.0预设 / 像素指定1:1 / 16:9 / 9:16 / 4:3 / 3:4支持参考图片
能力5.55.0-flash5.0-pro5.0-lite / 4.5 / 4.0
ModelNameSISISISeedream
文生图✅✅✅✅
参考图生图✅✅✅(最多 10 张)✅
图片分层(layer_decomposition)✅✅——
分辨率指定方式Resolution 直接传 1K / 1.5K / 2K / 4K同 5.5Resolution + ExtInfo.size 像素预设 / 像素指定

5.5 / 5.0-flash 的比例取值按接入指南整理;指南原文写作「3:3/2:3」,按上下文应为 3:2 / 2:3。指南把两个版本写在同一张参数表里(「SI 5.0-flash/5.5」),没有列出两者在画质、速度上的差异。

5.0-pro 的像素尺寸在 ExtInfo.AdditionalParameters.size 中指定。以正方形为基准为 1024x1024 / 1536x1536 / 2048x2048。1.5K 不放入 OutputConfig.Resolution,而用 size 指定。

请求参数 ​

参数必填类型说明
ModelName必填String5.5 / 5.0-flash / 5.0-pro:SI。原有 5.0-lite / 4.5 / 4.0:Seedream
ModelVersion必填String5.5 / 5.0-flash / 5.0-pro / 5.0-lite / 4.5 / 4.0
Prompt必填String生成提示词
FileInfos.N可选Array参考图片数组。5.0-pro 最多 10 张。各项指定 Type=Url、Url
OutputConfig.AspectRatio可选String1:1 / 16:9 / 9:16 / 4:3 / 3:4 等
OutputConfig.OutputImageCount可选Integer生成张数。下方示例生成 1 张
OutputConfig.Resolution可选String分辨率预设。以 1.5K 指定像素时省略
OutputConfig.StorageMode可选StringTemporary / Permanent
ExtInfo可选String扩展选项。在 AdditionalParameters 中放入 JSON 字符串,再将整体编码为 JSON 字符串。5.0-pro 用 size;5.5 / 5.0-flash 图片分层用 layer_decomposition

按版本调用 ​

版本文生图生图片分层示例
5.5✅✅✅5.5
5.0-flash✅✅✅5.0 Flash
5.0-pro✅✅—5.0 Pro
5.0-lite / 4.5 / 4.0✅✅—原有版本

5.5 ​

2026-11-17 上线。ModelName=SI,ModelVersion=5.5。参数与 5.0 Flash 完全一致:分辨率直接用 OutputConfig.Resolution 传 1K / 1.5K / 2K / 4K,图片分层同样用 layer_decomposition。从 5.0-flash 迁移只需把 ModelVersion 换成 5.5。

文生图

json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.5",
  "Prompt": "A young artist in a bunny cosplay outfit hand-copies the image on her computer screen onto a canvas as an oil painting",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "2K",
    "AspectRatio": "16:9"
  }
}

图生图:参考图放在 FileInfos。

json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.5",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/reference.png"
    }
  ],
  "Prompt": "保持房间结构不变,把家具与软装改成日式侘寂风格",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "1K",
    "AspectRatio": "9:16"
  }
}

图片分层:写法见 5.0 Flash / 图片分层,只把 ModelVersion 换成 5.5。

5.0 Flash ​

2026-11-12 上线。ModelName=SI,ModelVersion=5.0-flash。分辨率直接用 OutputConfig.Resolution 传 1K / 1.5K / 2K / 4K,不需要像 5.0-pro 那样在 ExtInfo 里写像素 size。

文生图

json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.0-flash",
  "Prompt": "一位身着兔子 coser 服饰的少女艺术家,正把电脑屏幕上的图像手工临摹到画布上,创作一幅油画;而这张照片记录的正是她绘制这幅「递归图像」的过程",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "1K",
    "AspectRatio": "9:16"
  }
}

图生图:参考图片放在 FileInfos。

json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.0-flash",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/reference.png"
    }
  ],
  "Prompt": "保持空间骨架不变,把家具与软装改为日式侘寂风格",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "1K",
    "AspectRatio": "9:16"
  }
}

5.0 Flash / 图片分层 ​

把输入图片拆成多个图层。在 ExtInfo.AdditionalParameters 里设 layer_decomposition=true;Prompt 可省略。

参数(AdditionalParameters 内)类型说明
layer_decompositionBooleantrue:分层;false:不分层
json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.0-flash",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/reference.png"
    }
  ],
  "OutputConfig": {
    "StorageMode": "Temporary"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"layer_decomposition\\\":true}\"}"
}

AdditionalParameters 解码后的内容:

json
{ "layer_decomposition": true }

注意 ExtInfo 的两层转义

ExtInfo 是字符串,里面的 AdditionalParameters 又是一层字符串,所以内层引号要写成 \\\"。接入指南原文示例的转义层数不完整、且含尾逗号与全角逗号,直接复制会解析失败,请以本页写法为准。分层结果的返回结构(图层数、各层 FileInfos 的组织方式)接入指南未给出,以实际 DescribeTaskDetail 返回为准。

请求示例:5.0 Pro 与原有版本 ​

5.0 Pro / 基于文本的生成 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.0-pro",
  "Prompt": "A blue ceramic cup beside an orange on a white table. Product photography, soft daylight.",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "OutputImageCount": 1,
    "Resolution": "2K",
    "AspectRatio": "1:1"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"size\\\":\\\"2048x2048\\\"}\"}"
}

5.0 Pro / 参考与像素指定 ​

将参考图片按顺序传入 FileInfos 数组。下方请求生成一张 1536x1536 尺寸的图片。

json
{
  "SubAppId": 123456789,
  "ModelName": "SI",
  "ModelVersion": "5.0-pro",
  "Prompt": "Keep the blue cup in the reference images. Place a small orange next to it on a white table. Product photography.",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/reference-cup.png"
    }
  ],
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"size\\\":\\\"1536x1536\\\"}\"}"
}

原有版本 / 基于文本的生成 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Seedream",
  "ModelVersion": "4.0",
  "Prompt": "a serene japanese garden, soft morning light",
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

原有版本 / 参考图片请求 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Seedream",
  "ModelVersion": "4.0",
  "Prompt": "Change the background to a quiet garden; preserve the subject.",
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<host>/reference.jpg"
    }
  ]
}

响应示例 ​

用生成请求返回的 TaskId 以 DescribeTaskDetail 查询。当 AigcImageTask.Status=FINISH、ErrCode=0 时读取 Output.FileInfos 的结果。下方是 2048x2048 文本生成请求的完成响应。

json
{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "https://<output-host>/<image>.jpg",
          "MetaData": {
            "Width": 2048,
            "Height": 2048,
            "Container": "image2",
            "Size": 231055
          }
        }
      ]
    }
  }
}

特殊设置 ​

模型调用名与像素指定 ​

5.5 / 5.0-flash / 5.0-pro 在 VOD 使用 ModelName=SI;5.0-pro 在 MPS 使用 ModelName=Seedream。区分两条路径的模型调用名与扩展参数格式。

参考生成在 FileInfos 中放入 Type=Url、Url。5.0-pro 最多可传递 10 张图片。1536x1536 输出省略 Resolution,用 ExtInfo 的 size 指定。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages