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 上线)共用同一套参数,都支持图片分层。
基本信息
| 项目 | 取值 |
|---|---|
| ModelName | SI(5.5 / 5.0-flash / 5.0-pro)/ Seedream(5.0-lite / 4.5 / 4.0) |
| ModelVersion | 5.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-flash | 1K / 1.5K / 2K / 4K(OutputConfig.Resolution) | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 | 支持(图生、图片分层) |
5.0-pro | 1K / 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.5 | 5.0-flash | 5.0-pro | 5.0-lite / 4.5 / 4.0 |
|---|---|---|---|---|
ModelName | SI | SI | SI | Seedream |
| 文生图 | ✅ | ✅ | ✅ | ✅ |
| 参考图生图 | ✅ | ✅ | ✅(最多 10 张) | ✅ |
图片分层(layer_decomposition) | ✅ | ✅ | — | — |
| 分辨率指定方式 | Resolution 直接传 1K / 1.5K / 2K / 4K | 同 5.5 | Resolution + 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 | 必填 | String | 5.5 / 5.0-flash / 5.0-pro:SI。原有 5.0-lite / 4.5 / 4.0:Seedream |
ModelVersion | 必填 | String | 5.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 | 可选 | String | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 等 |
OutputConfig.OutputImageCount | 可选 | Integer | 生成张数。下方示例生成 1 张 |
OutputConfig.Resolution | 可选 | String | 分辨率预设。以 1.5K 指定像素时省略 |
OutputConfig.StorageMode | 可选 | String | Temporary / 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。
文生图
{
"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。
{
"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。
文生图
{
"SubAppId": 123456789,
"ModelName": "SI",
"ModelVersion": "5.0-flash",
"Prompt": "一位身着兔子 coser 服饰的少女艺术家,正把电脑屏幕上的图像手工临摹到画布上,创作一幅油画;而这张照片记录的正是她绘制这幅「递归图像」的过程",
"OutputConfig": {
"StorageMode": "Temporary",
"Resolution": "1K",
"AspectRatio": "9:16"
}
}图生图:参考图片放在 FileInfos。
{
"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_decomposition | Boolean | true:分层;false:不分层 |
{
"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 解码后的内容:
{ "layer_decomposition": true }注意 ExtInfo 的两层转义
ExtInfo 是字符串,里面的 AdditionalParameters 又是一层字符串,所以内层引号要写成 \\\"。接入指南原文示例的转义层数不完整、且含尾逗号与全角逗号,直接复制会解析失败,请以本页写法为准。分层结果的返回结构(图层数、各层 FileInfos 的组织方式)接入指南未给出,以实际 DescribeTaskDetail 返回为准。
请求示例:5.0 Pro 与原有版本
5.0 Pro / 基于文本的生成
{
"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 尺寸的图片。
{
"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\\\"}\"}"
}原有版本 / 基于文本的生成
{
"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"
}原有版本 / 参考图片请求
{
"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 文本生成请求的完成响应。
{
"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 指定。