GPT Image 2 API로 이미지 생성 및 편집

생성 route 호출

GPT Image 2 is an image model you call over the OpenAI-compatible surface: send a prompt to /v1/images/generations with model gpt-image-2 and an Authorization: Bearer header, and you get back one PNG. No separate image plan, no second key — the same sk-pool credential and prepaid balance that cover GPT, Claude and Gemini calls settle image usage too.

공식 GPT Image 필드는 이 풀에 맞춰 변환됩니다. user, stream, moderation, style 같은 추가 키는 400이 아니라 무시됩니다. quality medium/high/auto도 풀의 low 티어로 생성됩니다. output_format jpeg 또는 webp는 네이티브 PNG를 로컬에서 트랜스코드합니다. response_format=url은 무시되고 본문은 항상 b64_json입니다. n은 1–10일 수 있으며 추가 이미지는 같은 홈에서 순차 네이티브 턴입니다. background=auto는 opaque입니다. transparent는 컷아웃 문장을 붙입니다. size는 픽셀 잠금이 아니라 비율입니다. 2048x2048과 3840x2160은 1:1과 16:9로 매핑되며 PNG는 약 1.57메가픽셀로 남고 응답 size는 실제 IHDR입니다. 편집은 같은 모델과 PNG, JPEG 또는 WebP 최대 5개(각 50 MB 이하)를 multipart/form-data로 /v1/images/edits에 보냅니다. image 또는 image[]를 쓰세요. mask는 무시됩니다.

함께 보기: GPT Image 2 API 비용과 B2C 50% 할인

영역 inpaint와 Responses image_generation

/v1/images/edits의 mask 필드는 지원하지 않습니다. 일부만 바꾸거나 GPT 텍스트 모델에서 hosted image_generation 도구를 쓰려면 POST /v1/responses를 호출하세요(Chat Completions는 같은 hosted 도구를 Responses로 매핑). 편집 시 원본 PNG는 input_image, tools: [{type:"image_generation", …}]. 마스크는 input_image_mask.image_url(PNG data URL). 투명 픽셀이 수정 영역입니다. file_id는 Files API가 없어 실패합니다.

import base64, os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APITOKEN_API_KEY"],
    base_url="https://router.apitoken.sale/v1",
)

def png_url(path):
    return "data:image/png;base64," + base64.b64encode(Path(path).read_bytes()).decode()

response = client.responses.create(
    model="gpt-5.6-sol",
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "Change only the masked region."},
            {"type": "input_image", "image_url": png_url("photo.png")},
        ],
    }],
    tools=[{
        "type": "image_generation",
        "output_format": "webp",
        "partial_images": 2,
        "input_image_mask": {"image_url": png_url("mask.png")},
    }],
)

• gpt-image-2가 아니라 GPT 텍스트 모델(예: gpt-5.6-sol)을 /v1/responses 또는 /v1/chat/completions에 보냅니다.
• Responses image_generation은 output_format jpeg|webp와 partial_images 1..=3을 전달합니다. SSE는 response.image_generation_call.partial_image를 보냅니다.
• background=transparent는 opaque로 바뀌고 input_fidelity는 제거됩니다. /v1/images/*는 여전히 PNG만 출력하며 partial을 스트리밍하지 않습니다.

이미지 요금 계산

• cached text와 image input은 일반 input 가격의 25%입니다.
• gpt-image-2는 immutable snapshot gpt-image-2-2026-04-21의 alias입니다.
• image usage는 GPT, Claude, Gemini 호출과 같은 선불 잔액에서 결제됩니다.

자주 묻는 질문

관련 가이드