Tokenhub APILast Updated 2026-09-30

GPT-Image2

On this page

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

요청 예시

LANGUAGE
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
}'

응답 예시

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

LANGUAGE
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[] 필드를 반복해 전달합니다.

LANGUAGE
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'

응답 예시

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