MPS APILast Updated 2026-09-07

Seedream

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcImageTask

기본 정보

항목	값
ModelName	`Seedream`
ModelVersion	`5.0-pro` / `5.0-lite` / `4.5` / `4.0`
가드레일 해제 지원	미지원

버전별 지원 규격

버전	출력 규격	입력 및 조건
공통	비율: `1:1` / `16:9` / `9:16` / `4:3` / `3:4` 해상도 지정: 프리셋 또는 size로 픽셀 지정; MPS `5.0`-pro/lite는 AdditionalParameters.size 사용	—

범용 이미지 생성 엔진입니다.

요청 파라미터

파라미터	필수	타입	설명
`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` 전달 형식은 추가 설정 참조

요청 예시

LANGUAGE
{
  "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/"
  }
}

참조 이미지 요청

LANGUAGE
{
  "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 / 참조와 픽셀 지정

LANGUAGE
{
  "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"
}

응답 예시

LANGUAGE
{
  "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 전용

5.0-pro는 MPS 경로에서만 허용됩니다. VOD 경로에서는 5.0-lite / 4.5 / 4.0을 사용하세요.