Skip to content

Seedream โ€‹

Updated

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 โ€‹

ItemValue
ModelNameSeedream
ModelVersion5.0-pro / 5.0-lite / 4.5 / 4.0
Guardrail removal supportNot supported

Specifications Supported by Version โ€‹

VersionResolutionRatioReference Image
5.0-pro1K / 1.5K / 2K pixel specification1:1 / 16:9 / 9:16 / 4:3 / 3:4Up to 10
5.0-lite / 4.5 / 4.0Preset / pixel specification1:1 / 16:9 / 9:16 / 4:3 / 3:4Reference images supported

5.0-pro specifies the output pixels via AdditionalParameters.size. On a square basis, these are 1024x1024 / 1536x1536 / 2048x2048.

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Seedream
ModelVersionOptionalString5.0-pro / 5.0-lite / 4.5 / 4.0
PromptRequiredStringGeneration prompt. Up to 1000 characters
EnhancePromptOptionalBooleanAutomatic prompt refinement. Default false
ImageInfos.NOptionalArrayReference image array. Used for image-to-image and reference-based generation
ExtraParametersOptionalObjectOutput options such as Resolution / AspectRatio
AdditionalParametersOptionalStringA 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.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages