GPT-Image-2 API 가이드

GPT-Image-2 — OpenAI 이미지 생성 API

TokenHub 통합 API를 통해 OpenAI의 최신 이미지 생성 model에 접근할 수 있습니다. 완전한 OpenAI-compatible 지원과 함께, 동기식 응답(폴링 불필요), 최대 4K까지의 여러 크기, 품질 수준, PNG/JPEG/WebP 출력 형식을 지원합니다. 텍스트-투-이미지(t2i)와 이미지-투-이미지 편집(i2i, 다중 이미지 합성 및 인페인팅)을 모두 지원합니다. 이 가이드는 전체 연동 과정을 안내합니다.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1API Key 받기

방문하세요 tokenhub.store 계정을 생성합니다(GitHub / Google 로그인 지원)
Dashboard → API Keys로 이동해 "Create New Key"를 클릭하세요
Dashboard → Billing으로 이동해 Credits를 충전하세요(1 Credit = $1 USD)
API Key를 복사하세요(형식: th-xxxxxxxxxxxx...)

⚠️ API Key는 생성 시 한 번만 표시됩니다. 안전하게 보관하세요. 분실하면 새로 생성해야 합니다.

2API 개요

Base URL

https://tokenhub.store/api/v1

인증

모든 요청에는 헤더에 API Key가 필요합니다:

Header

Authorization: Bearer th-your-api-key

엔드포인트(동기식, OpenAI-compatible)

POST

/images/generations

텍스트-투-이미지. 텍스트 프롬프트로 이미지를 생성합니다.

POST

/images/edits

이미지-투-이미지 편집. 단일 이미지 편집, 다중 이미지 합성, 마스크를 사용한 선택적 인페인팅을 지원합니다.

3요금

단계	가격	해상도 범위
1K	$0.125 / image	긴 변 ≤ 1536 px(예: 1024×1024, 1024×1536)
2K	$0.250 / image	긴 변 ≤ 2048 px(예: 2048×2048)
4K	$0.500 / image	최장 변 > 2048 px (예: 4096×4096)

출력 해상도 티어(크기의 최장 변 기준)에 따라 이미지당 고정 요금이 적용됩니다. n장의 이미지 = 단가 × n. 실패한 호출은 과금되지 않습니다.

최장 변 기준 티어 매핑: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). 예: 1024×1024와 1024×1536은 모두 1K, 2048×2048은 2K, 4096×4096은 4K입니다.

4요청 파라미터

파라미터	유형	필수 여부	기본값	설명
model	string	필수	—	모델 ID. "openai/gpt-image-2"(또는 짧은 형식 "gpt-image-2")를 사용하세요.
prompt	string	필수	—	생성할 이미지를 설명하는 텍스트 프롬프트입니다.
n	integer	선택	1	생성할 이미지 수(1–10).
size	string	선택	1024x1024	출력 크기입니다. 옵션: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	선택	auto	생성 품질입니다. 옵션: auto, low, medium, high. 품질이 높을수록 더 많은 Tokens를 사용합니다.
format	string	선택	png	출력 이미지 형식입니다. 옵션: png, jpeg, webp.

/images/edits (i2i)의 추가 필드

파라미터	유형	필수 여부	기본값	설명
image	file / string \| array	필수	—	편집할 입력 이미지입니다. multipart의 파일 또는 JSON의 URL / base64 data URI를 지원합니다. 여러 이미지를 제공하면 하나의 출력으로 합성할 수 있습니다.
mask	file / string	선택	—	선택 사항인 인페인팅 마스크입니다. 투명한 영역은 다시 생성되며, 불투명한 영역은 유지됩니다.
input_fidelity	string	선택	low	입력을 얼마나 가깝게 유지할지 설정합니다. 옵션: low, high. identity/layout를 유지하려면 high를 사용하고, 더 과감한 변형에는 low를 사용하세요.
output_format	string	선택	png	편집 엔드포인트에서 'format'의 별칭입니다. 옵션: png, jpeg, webp.
output_compression	integer	선택	100	압축 수준 0–100(jpeg / webp에만 적용).

5완전한 curl 예제

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

응답:

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Python 전체 예제

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7JavaScript / Node.js 전체 예제

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8사용 팁

영문 프롬프트가 일반적으로 가장 좋은 결과를 내며, 중국어도 지원됩니다.
Response의 data[].url은 일반 https URL이거나 data URI(base64)일 수 있습니다. 디스크에 저장할 때 두 경우 모두 처리하세요.
비용을 줄이려면 초안에는 low/medium 품질을 사용하고, 최종 출력에만 high/4K 크기를 사용하세요.
이 엔드포인트는 동기식입니다. task id도 없고 polling도 없습니다. 요청은 크기와 품질에 따라 보통 5–30초 내에 완료됩니다.
대형 이미지를 처리할 때 조기 연결 종료를 방지하려면 클라이언트 측 HTTP timeout을 120초 이상으로 설정하세요.

9FAQ

시작할 준비가 되셨나요?

TokenHub에 가입하고 지금 바로 GPT-Image-2 API를 사용해 보세요

API Key 받기 Credits 충전