MPS APILast Updated 2026-10-01

Vega ImageHOT

On this page

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

Vega Image는 텍스트 기반 이미지 생성과 참조 이미지 편집을 지원합니다. Pro / Flash / Lite를 제공하며, 생성 결과는 DescribeAigcImageTask로 조회합니다.

기본 정보

항목	값
ModelName	`wand-vega-image`
ModelVersion	`1.0-pro` / `1.0-flash` / `1.0-lite`
입력	텍스트 / 참조 이미지 URL
결과 조회	`DescribeAigcImageTask`
결과 보관	`StoreCosParam`에 지정한 COS 버킷
가드레일 해제 지원	지원

버전별 지원 규격

버전	해상도	비율	참조 이미지
`1.0-pro`	`1920×1080`	`16:9`	`2장` 구성
`1.0-flash`	`1920×1080`	`16:9`	`2장` 구성
`1.0-lite`	`1920×1080`	`16:9`	`2장` 구성

표의 출력 크기는 AdditionalParameters의 size에 1920x1080을 지정한 구성입니다. 참조 이미지는 각 항목의 ImageUrl로 전달합니다.

참조 이미지 규격

버전	예제 참조 이미지 수	파일당 권장 용량	형식
`1.0-pro`	`2장` 구성	`10MB` 이하	PNG / JPEG
`1.0-flash`	`2장` 구성	`10MB` 이하	PNG / JPEG
`1.0-lite`	`2장` 구성	`10MB` 이하	PNG / JPEG

참조 이미지는 ImageInfos[].ImageUrl에 전달합니다. 표의 2장은 연동 예제의 입력 구성으로, 모델의 최대 장수를 의미하지 않습니다. 참조 URL은 생성 서비스에서 다운로드할 수 있어야 하며, 비공개 객체는 유효한 서명 URL을 사용하십시오.

생성 예시

설원 배경과 캐릭터 시트를 함께 입력해 하나의 장면을 생성합니다. 첫 번째 이미지는 장소와 조명, 두 번째 이미지는 인물의 얼굴과 의상을 참조합니다.

참조 이미지

Pro / Lite 생성 결과

두 버전에 동일한 참조 이미지와 프롬프트를 사용했습니다. 출력 크기는 1920×1080입니다. 참조 이미지의 역할을 분리해 지정하고, 캐릭터 시트의 여러 뷰 대신 인물 한 명이 등장하는 장면을 요청합니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	`wand-vega-image`
`ModelVersion`	필수	String	`1.0-pro` / `1.0-flash` / `1.0-lite`
`Prompt`	필수	String	생성할 이미지 또는 참조 이미지의 편집 지시문
`EnhancePrompt`	선택	Boolean	프롬프트 자동 보정. 예시는 `false` 사용
`ImageInfos.N`	선택	Array	참조 이미지 목록
`ImageInfos.N.ImageUrl`	조건부 필수	String	참조 이미지의 HTTPS URL
`AdditionalParameters`	선택	String	모델 전용 옵션을 담는 JSON 문자열. `size`로 출력 크기 지정
`StoreCosParam`	선택	Object	결과를 저장할 COS 버킷과 경로
`StoreCosParam.` `CosBucketName`	조건부 필수	String	결과 저장 버킷 이름
`StoreCosParam.` `CosBucketRegion`	조건부 필수	String	버킷 리전. 예: `ap-singapore`
`StoreCosParam.` `CosBucketPath`	선택	String	결과 객체의 경로 접두사

요청 예시

텍스트 기반 생성

LANGUAGE
{
  "ModelName": "wand-vega-image",
  "ModelVersion": "1.0-pro",
  "Prompt": "A golden retriever astronaut floating inside a spacecraft cupola window, wearing a white spacesuit and dark sunglasses, Earth visible behind the glass, cinematic lighting.",
  "EnhancePrompt": false,
  "AdditionalParameters": "{\"size\":\"1920x1080\"}",
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-singapore",
    "CosBucketPath": "/vega/"
  }
}

참조 이미지로 장면 구성

아래 요청은 위 Pro 결과에 사용한 프롬프트와 참조 구성입니다. Lite는 ModelVersion을 1.0-lite로 지정합니다.

LANGUAGE
{
  "ModelName": "wand-vega-image",
  "ModelVersion": "1.0-pro",
  "Prompt": "Use reference image 1 as the snowy forest location and reference image 2 only as the identity and outfit reference for one adult woman. Create ONE cinematic photograph, not a character sheet or collage. The same woman stands on the snowy path, framed from mid-thigh up, slightly left of center, looking back toward camera with a quiet thoughtful expression. Preserve her face, short layered dark hair, lavender zip-up track jacket with cream sleeve stripes, white inner shirt, striped gray trousers, small hoop earrings and delicate necklace. Preserve the forest's snow-laden conifers, rocky mountains and blue winter light. Add natural cold breath and a few drifting snowflakes. Realistic skin texture, believable feet/body placement and contact shadows, coherent lighting and perspective, soft backlight, subtle cinematic depth of field, premium film still, no text, no logos, no duplicated people.",
  "EnhancePrompt": false,
  "ImageInfos": [
    {
      "ImageUrl": "https://wand.tencentpoc.com/uploads/vega/mps/snow-forest.png"
    },
    {
      "ImageUrl": "https://wand.tencentpoc.com/uploads/vega/mps/gena-reference.png"
    }
  ],
  "AdditionalParameters": "{\"size\": \"1920x1080\"}",
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-singapore",
    "CosBucketPath": "/vega/"
  }
}

응답 및 결과 조회

생성 요청은 TaskId를 반환합니다. DescribeAigcImageTask에 같은 TaskId를 전달합니다.

LANGUAGE
{
  "Response": {
    "TaskId": "2600012260-AigcImage-10c86f2c4eef4851814f073682902258",
    "RequestId": "f81c4bfa-2311-4882-b172-2ebebbd5d8c3"
  }
}

LANGUAGE
{
  "TaskId": "2600012260-AigcImage-10c86f2c4eef4851814f073682902258"
}

Status=DONE이며 ImageUrls에 주소가 반환되면 결과를 사용할 수 있습니다.

LANGUAGE
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "ImageUrls": [
      "https://example-1250000000.cos.ap-singapore.myqcloud.com/vega/result.png"
    ],
    "RequestId": "f81c4bfa-2311-4882-b172-2ebebbd5d8c3"
  }
}

특수 설정

출력 크기

AdditionalParameters는 JSON 객체를 문자열로 직렬화한 값입니다. size에는 가로x세로 형식의 픽셀 크기를 지정합니다.

LANGUAGE
{
  "AdditionalParameters": "{\"size\":\"1920x1080\"}"
}

참조 이미지의 역할 지정

ImageInfos의 순서에 맞춰 프롬프트에 각 이미지의 역할을 설명합니다. 배경 이미지에서는 장소와 조명을, 캐릭터 이미지에서는 얼굴 / 헤어스타일 / 의상을 참조하도록 지정합니다. 캐릭터 시트는 인물 설정용으로 사용하고, 결과의 인원수와 구도는 별도로 명시합니다.

출력 파일은 Pro / Lite에서 PNG, Flash에서 JPEG로 반환됩니다. 저장 시 반환된 파일 형식과 확장자를 사용합니다.

결과 보관

StoreCosParam을 지정하면 생성 결과가 해당 COS 버킷에 저장됩니다. 비공개 버킷의 결과는 COS SDK 또는 서명 URL로 내려받습니다. 인증, 요청 실행과 저장 공통 규격은 API Reference를 참조하세요.