WAND-Vega-Image

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask

WAND-Vega-Image는 텍스트 기반 이미지 생성과 참조 이미지 편집을 지원합니다. Pro / Flash / Lite를 제공하며 생성 결과는 DescribeTaskDetail 또는 완료 이벤트로 확인합니다.

기본 정보

항목	값
ModelName	wand-vega-image
ModelVersion	1.0-pro / 1.0-flash / 1.0-lite
입력	텍스트 / 참조 이미지
결과 조회	DescribeTaskDetail
가드레일 해제 지원	지원

버전별 지원 규격

버전	해상도	비율	참조 이미지
1.0-pro	1K / 2K / 4K	1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9	최대 6장
1.0-flash	1K / 2K / 4K	1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9	최대 6장
1.0-lite	1K / 2K / 4K	1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9	최대 3장

Resolution=2K, AspectRatio=16:9의 출력 크기는 2560×1440입니다.

참조 이미지 규격

버전	참조 이미지 수	파일당 용량	형식
1.0-pro	최대 6장	10MB 이하	PNG / JPEG
1.0-flash	최대 6장	10MB 이하	PNG / JPEG
1.0-lite	최대 3장	10MB 이하	PNG / JPEG

참조 이미지는 FileInfos.Url에 전달합니다. 파일당 용량 제한과 이미지 개수 제한을 각각 적용합니다. 참조 URL은 생성 서비스에서 다운로드할 수 있어야 하며, 비공개 객체는 유효한 서명 URL을 사용하십시오.

생성 예시

여름 시골길의 일러스트

조선시대에 등장한 사이버로봇 / Pro / 2K

요청 파라미터

파라미터	필수	타입	설명
SubAppId	필수	Integer	VOD 애플리케이션 ID
ModelName	필수	String	wand-vega-image
ModelVersion	필수	String	1.0-pro / 1.0-flash / 1.0-lite
Prompt	조건부 필수	String	생성 또는 편집 지시문. FileInfos가 없으면 필수
FileInfos.N	선택	Array	참조 이미지. Type=Url / File / Base64
FileInfos.N.Url	조건부 필수	String	Type=Url일 때 이미지 URL
FileInfos.N.FileId	조건부 필수	String	Type=File일 때 VOD 미디어 ID
FileInfos.N.Base64	조건부 필수	String	Type=Base64일 때 이미지의 Base64 문자열
OutputConfig. Resolution	선택	String	출력 해상도
OutputConfig. AspectRatio	선택	String	출력 비율
OutputConfig. StorageMode	선택	String	Temporary / Permanent
OutputConfig. LogoAdd	선택	String	로고 워터마크. Enabled / Disabled
OutputConfig. OutputImageCount	선택	Integer	Flash / Pro의 출력 이미지 수 설정. 예시는 1 사용
InputRegion	선택	String	입력 지역. 해외 요청은 Oversea

요청 예시

텍스트 기반 생성

{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-image",
  "ModelVersion": "1.0-pro",
  "Prompt": "A cybernetic robot wearing hanbok-inspired armor and a gat in a Joseon palace courtyard, rain and lantern light, cinematic realism.",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "2K",
    "AspectRatio": "16:9",
    "LogoAdd": "Disabled"
  }
}

참조 이미지 편집

{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-image",
  "ModelVersion": "1.0-pro",
  "Prompt": "Keep the person and bicycle. Change the season to autumn with warm orange foliage.",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "2K",
    "AspectRatio": "16:9",
    "LogoAdd": "Disabled",
    "OutputImageCount": 1
  },
  "FileInfos": [
    {
      "Type": "Url",
      "Url": ""
    }
  ]
}

Python SDK

import json
import os
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.vod.v20180717 import vod_client, models

profile = ClientProfile
profile.httpProfile = HttpProfile
profile.httpProfile.endpoint = "vod.intl.tencentcloudapi.com"
client = vod_client.VodClient(
    credential.Credential(
        os.environ["TENCENTCLOUD_SECRET_ID"],
        os.environ["TENCENTCLOUD_SECRET_KEY"],
    ),
    "ap-singapore",
    profile,
)
params = {
    "SubAppId": 123456789,
    "ModelName": "wand-vega-image",
    "ModelVersion": "1.0-pro",
    "Prompt": "A cybernetic robot in a Joseon palace courtyard, cinematic light",
    "OutputConfig": {
        "StorageMode": "Temporary",
        "Resolution": "2K",
        "AspectRatio": "16:9",
        "LogoAdd": "Disabled",
    },
}
request = models.CreateAigcImageTaskRequest
request.from_json_string(json.dumps(params))
response = client.CreateAigcImageTask(request)
print(response.to_json_string)

응답 및 결과 조회

생성 요청은 TaskId를 반환합니다.

{
  "TaskId": "1500033704-AigcImageTask-b988f28b31d06c2ba1fc9ad1428c02e8t",
  "RequestId": "52ee718a-4423-409e-a96c-a7797d6879b6"
}

DescribeTaskDetail에 같은 SubAppId와 TaskId를 전달합니다.

{
  "SubAppId": 123456789,
  "TaskId": "1500033704-AigcImageTask-b988f28b31d06c2ba1fc9ad1428c02e8t"
}

AigcImageTask.Status=FINISH, ErrCode=0이면 생성이 완료됩니다. 이미지 주소는 AigcImageTask.Output.FileInfos.FileUrl에 반환됩니다.

{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "",
          "MetaData": {
            "Width": 2560,
            "Height": 1440
          }
        }
      ]
    }
  }
}

특수 설정

Base64 참조 이미지

Type=Base64와 Base64 필드를 사용합니다. JPEG / JPG / PNG / WEBP를 지원하며, 인코딩 전 파일 크기 합계는 7MB 이하입니다. data:image/...;base64, 접두사는 포함하지 않습니다.

import base64

with open("reference.png", "rb") as image:
    params["FileInfos"] = [{
        "Type": "Base64",
        "Base64": base64.b64encode(image.read).decode("ascii"),
    }]

결과 보관과 완료 이벤트

StorageMode=Temporary는 임시 결과 URL을 반환합니다. VOD 미디어로 보관하려면 Permanent를 사용합니다. 완료 알림은 일반 콜백 또는 신뢰할 수 있는 이벤트 알림을 사용할 수 있습니다. 인증과 콜백 공통 규격은 API Reference를 참조하세요.