Seedream
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcImageTask
Seedream 是图片生成模型,支持文生图与多图参考生成(5.0-pro 最多 10 张参考图)。提供 5.0-pro、5.0-lite、4.5、4.0 多个版本。
基本信息
| 项目 | 取值 |
|---|---|
| ModelName | Seedream |
| ModelVersion | 5.0-pro / 5.0-lite / 4.5 / 4.0 |
| 支持解除护栏 | 不支持 |
各版本支持规格
| 版本 | 分辨率 | 比例 | 参考图 |
|---|---|---|---|
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.0-pro 通过 AdditionalParameters.size 指定输出像素。以正方形为基准为 1024x1024 / 1536x1536 / 2048x2048。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Seedream |
ModelVersion | 可选 | String | 5.0-pro / 5.0-lite / 4.5 / 4.0 |
Prompt | 必填 | String | 生成提示词。最多 1000 字 |
EnhancePrompt | 可选 | Boolean | 提示词自动优化。默认值 false |
ImageInfos.N | 可选 | Array | 参考图数组。用于 image-to-image 及参考生成 |
ExtraParameters | 可选 | Object | Resolution / AspectRatio 等输出选项 |
AdditionalParameters | 可选 | String | 承载模型专用选项的 JSON 字符串。seed 的传递格式请参考 附加配置 |
请求示例
json
{
"ModelName": "Seedream",
"ModelVersion": "5.0-lite",
"Prompt": "a young woman in traditional hanbok standing by a moonlit lake",
"EnhancePrompt": true,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}参考图请求
json
{
"ModelName": "Seedream",
"ModelVersion": "5.0-lite",
"Prompt": "Change the background to a quiet garden; preserve the subject.",
"EnhancePrompt": true,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"ImageInfos": [
{
"ImageUrl": "https://<host>/reference.jpg"
}
]
}5.0-pro / 参考图与像素指定
json
{
"ModelName": "Seedream",
"ModelVersion": "5.0-pro",
"Prompt": "Preserve the product and replace the background with a clean studio.",
"NegativePrompt": "blur, extra objects",
"EnhancePrompt": false,
"ImageInfos": [
{
"ImageUrl": "https://<host>/product.jpg"
}
],
"AdditionalParameters": "{\"size\":\"2048x2048\"}",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"Operator": "wiki-example"
}响应示例
json
{
"Response": {
"Status": "DONE",
"Message": "ok",
"ImageUrls": [
"https://aigc-output-image-<id>.cos.<region>.myqcloud.com/<file>.png?q-sign-algorithm=sha1&..."
],
"RequestId": "<request-id>"
}
}特殊配置
附加选项
5.0-pro 在 MPS 中使用 ModelName=Seedream,在 VOD 中使用 ModelName=SI。MPS 将 JSON 字符串直接传入 AdditionalParameters,而 VOD 则通过 ExtInfo.AdditionalParameters 传递。