WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

↑ ↓ 이동 ↵ 열기전체 결과 보기 →
VOD APILast Updated 2026-10-01

Vega Image

On this page

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

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

요청 예시

텍스트 기반 생성

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

참조 이미지 편집

LANGUAGE
{
  "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": "https://wand.tencentpoc.com/uploads/vega/vod-image-countryside.webp"
    }
  ]
}

Python SDK

LANGUAGE
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를 반환합니다.

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

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

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

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

LANGUAGE
{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "https://wand.tencentpoc.com/uploads/vega/vod-image-joseon-robot-pro.webp",
          "MetaData": {
            "Width": 2560,
            "Height": 1440
          }
        }
      ]
    }
  }
}

특수 설정

Base64 참조 이미지

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

LANGUAGE
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를 참조하세요.

Contact us about WAND