GPT-Image2

TokenHub 경로로 호출하는 GPT-Image2 이미지 생성입니다. 동기 방식으로 처리되고 응답 본문에 결과가 바로 포함됩니다.

기본 정보

항목	값
model	custom-model-og-v2
지원 버전	custom-model-og-v2
기본값	model=custom-model-og-v2 / n=1 / quality=auto / response_format=url
지원 작업	텍스트 → 이미지 생성, 이미지 편집
출력 크기	auto 또는 1024x1024 형식의 커스텀 지정
지원 비율	장단변 비율 3:1 이하 (커스텀 지정 시)
반환 형식	url / b64_json
가드레일 해제 지원	미지원

엔드포인트

항목	값
HTTP 메서드	POST
요청 도메인	https://tokenhub-intl.tencentcloudmaas.com
텍스트 → 이미지 생성	/v1/wand/og-image/generation
이미지 편집 (JSON)	/v1/wand/og-image/edits
이미지 편집 (multipart)	/v1/wand/og-image/multipart-edits
인증	Authorization: Bearer <API_KEY>
결과 반환	동기. 응답 본문에 생성 결과 포함

리전별 접속 주소

위 주소는 Singapore 기준입니다. Guangzhou, Silicon Valley 등 리전별 주소와 백업 주소는 API 사용 가이드를 참조하세요.

사전 준비

• TokenHub 서비스 활성화와 API Key 발급이 완료되어 있어야 합니다. 절차는 TokenHub Quick Start를 참조하세요.

입력 파라미터

파라미터	필수	타입	설명
model	선택	String	custom-model-og-v2
prompt	선택	String	생성 프롬프트. 최대 32,000자
size	선택	String	출력 크기. 1024x1024 형식의 커스텀 지정 또는 auto
quality	선택	String	auto / high / medium / low
n	선택	Integer	생성 장수. 1~10, 기본값 1
background	선택	String	배경 처리. opaque / auto
output_format	선택	String	출력 포맷. png / jpeg
output_compression	선택	Integer	압축 레벨 0~100. output_format=jpeg일 때만 적용
response_format	선택	String	반환 형식. url / b64_json. 기본값 url

size 제약

커스텀 크기는 각 변 3,840px 이하 / 16의 배수, 장단변 비율 3:1 이하, 총 픽셀 655,360~8,294,400으로 지정합니다.

출력 파라미터

파라미터	타입	설명
data	Array	생성 이미지 목록. response_format에 따라 url 또는 b64_json
output_format	String	실제 출력 포맷. 예: png
quality	String	적용된 화질. 예: auto
size	String	실제 출력 크기. 예: 1024x1024
background	String	적용된 배경 설정. 예: auto
created	Integer	생성 시각 (Unix timestamp, 초)
usage.total_tokens	Integer	사용 토큰 수
request_id	String	요청 확인에 사용하는 ID

요청 예시

curl --location 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/og-image/generation' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
  "model": "custom-model-og-v2",
  "quality": "low",
  "prompt": "A cat dancing",
  "size": "2048x2048",
  "n": 1
}'

응답 예시

{
  "background": "opaque",
  "created": 1786095835,
  "data": [
    {
      "url": "https://xxxxxxxxxxxx.png"
    },
    {
      "url": "https://xxxxxxxxxxxx.png"
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "2048x2048",
  "usage": {
    "total_tokens": 93323
  },
  "request_id": "eaa4b07b-ccde-40a4-b184-822e3c5a4e60"
}

이미지 편집

입력 이미지를 기반으로 이미지를 생성합니다. JSON 방식과 multipart 방식을 모두 지원하며, 응답 구조는 생성과 동일합니다.

입력 파라미터

파라미터	필수	타입	설명
model	선택	String	custom-model-og-v2
prompt	필수	String	편집 지시 프롬프트. 최대 32,000자
images	필수	Array	입력 이미지 배열. 1~16장
mask	선택	Object	부분 재생성(inpainting)용 마스크 이미지. 입력 이미지와 동일 크기
size	선택	String	출력 크기. 생성과 동일한 제약 적용
n	선택	Integer	생성 장수. 1~10, 기본값 1
quality	선택	String	auto / high / medium / low
background	선택	String	배경 처리. transparent / opaque / auto
output_format	선택	String	출력 포맷. png / jpeg
output_compression	선택	Integer	압축 레벨 0~100. output_format=jpeg일 때만 적용
response_format	선택	String	반환 형식. url / b64_json. 기본값 url

transparent는 PNG에서만

투명 배경은 background=transparent / output_format=png를 사용합니다.

요청 예시 (JSON)

curl --location 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/og-image/edits' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
  "model": "custom-model-og-v2",
  "quality": "low",
  "prompt": "Dancing",
  "images": [
    {
      "image_url": "https://xxxxxxxxxxxx.png"
    }
  ],
  "size": "2048x2048",
  "n": 2
}'

요청 예시 (multipart)

로컬 파일을 직접 올릴 때 사용합니다. 이미지는 image 필드를 반복해 전달합니다.

curl --location 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/og-image/multipart-edits' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model=custom-model-og-v2' \
  --form 'prompt=Dancing' \
  --form 'image=@input.png' \
  --form 'n=2' \
  --form 'size=2048x2048' \
  --form 'quality=low' \
  --form 'output_format=png'

응답 예시

{
  "background": "opaque",
  "created": 1786096322,
  "data": [
    {
      "url": "https://xxxxxxxxxxxx.png"
    },
    {
      "url": "https://xxxxxxxxxxxx.png"
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "2048x2048",
  "usage": {
    "total_tokens": 183284
  },
  "request_id": "705d12d2-9f68-4cfa-859a-733e449ea675"
}