Seedream

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: 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 전달 형식은 추가 설정 참조

요청 예시

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

참조 이미지 요청

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

{
  "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": {
    "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을 사용하세요.