Vega Image

Endpoint: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations
인증: Tokenhub API Key / Bearer

Vega Image는 텍스트로 이미지를 생성하거나 참조 이미지를 편집합니다. 1.5 Pro / Pro / Flash / Lite를 제공하며 요청 후 작업 ID로 결과를 조회합니다.

화이트리스트 등록이 필요한 모델입니다.

대상: Vega Image 1.5 Pro. 사용 전 모델 접근 권한을 신청하십시오.

기본 정보

버전별 지원 규격

Lite와 Flash는 참조 이미지 입력 비용이 없습니다. Pro는 처음 3장까지 무료이며, 4번째 이미지부터 입력 비용이 부과됩니다.

참조 이미지 규격

참조 이미지는 input[].content[].image_url에 전달합니다. 입력은 파일당 20MB 이하로 구성하고 이미지 개수는 전체 참조 배열을 기준으로 계산합니다. 참조 URL은 생성 서비스에서 다운로드할 수 있어야 하며, 비공개 객체는 유효한 서명 URL을 사용하십시오.

호출 절차

이미지 생성은 시간이 오래 걸리는 작업이므로 API는 다음 두 단계로 구성된 비동기 호출 방식을 사용합니다.

1. 작업 제출: 이미지 생성 API를 호출합니다. 성공하면 task_id가 반환됩니다.

2. 결과 폴링: status = completed가 될 때까지 task_id를 사용하여 작업 결과 조회 API를 호출한 후 결과에서 이미지 URL을 가져옵니다.

이미지 생성

API 설명

WAND-Vega 이미지 생성 API는 텍스트 기반 이미지 생성과 참조 이미지 기반 생성을 지원합니다. 입력한 참조 이미지와 텍스트 프롬프트를 기반으로 이미지를 생성하며, 이미지가 제공되지 않으면 텍스트 기반 이미지 생성을 수행합니다.

API: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations

요청 파라미터

요청 예시

텍스트 기반 이미지 생성

curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wand-vega-image-lite",
  "prompt": "A detailed painting of a butterfly",
  "size": "1024x1024"
}'

참조 이미지 기반 생성

curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wand-vega-image-lite",
  "prompt": "A seamless composition of all reference images",
  "input": [
    {
      "content": [
        {
          "type": "input_image",
          "image_url": "https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/reference-cup.png"
        }
      ]
    }
  ],
  "size": "1024x1024"
}'

응답 파라미터

응답 예시

{
  "task_id": "251380669-VegaImage-f91e7435e1e34dfa9898a451946bb3d3",
  "request_id": "5b7c57a3-e5e4-4df0-958b-e72d35582be1"
}

작업 결과 조회

조회 경로

이미지 생성 작업의 상태와 결과를 조회합니다. 작업을 제출하고 task_id를 받은 후 이 API를 폴링하여 결과를 가져옵니다.

API: GET https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/tasks/<task_id>

작업 제출 시 반환된 task_id로 3~5초 간격으로 조회합니다.

요청 파라미터

요청 예시

curl -X GET 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/tasks/<task_id>' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'

응답 파라미터

상태별 처리

응답 예시

{
  "task_id": "251380669-VegaImage-68a067d14b3c43c0961ce83373709f44",
  "status": "completed",
  "request_id": "92aa30e9-7549-4319-a0eb-467302d446f5",
  "data": [
    {
      "url": "https://aigc-image.cos.myqcloud.com/xxx/result.png"
    }
  ],
  "usage": {
    "total_tokens": 16200
  },
  "created_at": 1787560807,
  "finished_at": 1787560820
}

참조 입력과 결과 주소

input[].content[].image_url에는 다운로드 가능한 원본 이미지 URL을 전달합니다. 이미지 참조 입력은 소재 라이브러리 등록과 별개입니다.

생성 결과는 data[].url에서 받습니다. 반환된 COS 다운로드 URL은 쿼리 문자열을 포함한 전체 주소를 사용하며, 만료 전에 파일을 저장하십시오. 이미지 생성 결과의 URL과 영상용 asset://<id>는 서로 다른 값입니다.

출력 크기

size는 요청 크기입니다. 참조 입력을 사용하는 경우 저장 전에 결과 파일의 실제 너비·높이와 종횡비를 확인하십시오.

비율별 픽셀 규격

오류 코드

API 오류 코드를 참조하세요.