Seedream โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcImageTask
Seedream is an image generation model that supports text-to-image and multi-image reference generation (up to 10 reference images on 5.0-pro). Versions 5.0-pro, 5.0-lite, 4.5, and 4.0 are available.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | Seedream |
| ModelVersion | 5.0-pro / 5.0-lite / 4.5 / 4.0 |
| Guardrail removal support | Not supported |
Specifications Supported by Version โ
| Version | Resolution | Ratio | Reference Image |
|---|---|---|---|
5.0-pro | 1K / 1.5K / 2K pixel specification | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 | Up to 10 |
5.0-lite / 4.5 / 4.0 | Preset / pixel specification | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 | Reference images supported |
5.0-pro specifies the output pixels via AdditionalParameters.size. On a square basis, these are 1024x1024 / 1536x1536 / 2048x2048.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Seedream |
ModelVersion | Optional | String | 5.0-pro / 5.0-lite / 4.5 / 4.0 |
Prompt | Required | String | Generation prompt. Up to 1000 characters |
EnhancePrompt | Optional | Boolean | Automatic prompt refinement. Default false |
ImageInfos.N | Optional | Array | Reference image array. Used for image-to-image and reference-based generation |
ExtraParameters | Optional | Object | Output options such as Resolution / AspectRatio |
AdditionalParameters | Optional | String | A JSON string carrying model-specific options. For the seed delivery format, see Additional Configuration |
Request Example โ
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/"
}
}Reference Image Request โ
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 / Reference and Pixel Specification โ
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"
}Response 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>"
}
}Special Configuration โ
Additional Options โ
5.0-pro uses ModelName=Seedream in MPS and ModelName=SI in VOD. MPS passes the JSON string directly in AdditionalParameters, whereas VOD passes it via ExtInfo.AdditionalParameters.