GPT-Image 레거시 버전

신규 프로젝트의 경우 GPT-Image-2.5 / 2(공식; 텍스트 투 이미지 gpt-image-2.5-flare, 편집 gpt-image-2.5-sunburst) 또는 GPT-Image-2-All(역방향 채널, 이미지당 $0.025 균일가)을 사용하십시오. 이 페이지는 기존 연동 환경에서 문제를 해결하고 원활하게 마이그레이션할 수 있도록 레거시 버전의 핵심 내용을 유지합니다.

버전 라인업

모델 ID	출시일	엔드포인트	가격	상태
`gpt-image-2.5-flare` (스냅샷 `-2026-09-08`)	2026년 9월	`/v1/images/generations`, `/v1/images/edits`	입력 $5.00 / 출력 $30.00 per M tokens, gpt-image-2와 동일	현재 버전, 속도 우선, 텍스트-이미지 기본값
`gpt-image-2.5-sunburst` (스냅샷 `-2026-09-08`)	2026년 9월	`/v1/images/generations`, `/v1/images/edits`	위와 동일	현재 버전, 품질 및 편집 정밀도 우선
`gpt-image-2` (스냅샷 `-2026-04-21`)	2026년 4월	`/v1/images/generations`, `/v1/images/edits`	입력 $5.00 / 출력 $30.00 per M tokens	현재 버전, 이전 세대, `quality` 최대 `high`
`gpt-image-1.5`	2025년 12월	`/v1/images/generations`	입력 $5.00 / 출력 $10.00 per M tokens	사용 가능; `gpt-image-2.5-flare` / `sunburst`로 업그레이드 권장
`gpt-image-1`	2025년 4월	`/v1/images/generations`, `/v1/images/edits`	입력 $2.50 / 출력 $8.00 per M tokens	사용 가능; `gpt-image-2.5-flare` / `sunburst`로 업그레이드 권장
`gpt-image-1-mini`	2025년 4월	`/v1/images/generations`	`gpt-image-1`보다 낮음	사용 가능

간편 마이그레이션: model을 gpt-image-2 또는 gpt-image-2-all으로 변경합니다. 매개변수(size / quality / output_format, …)는 대부분 호환되므로 코드 구조를 변경할 필요가 없습니다.

공통 파라미터 (생성)

모든 레거시 버전은 동일한 생성 파라미터를 공유합니다:

파라미터	설명
`model`	`gpt-image-1.5` / `gpt-image-1` / `gpt-image-1-mini`
`prompt`	이미지 설명, 8,192 tokens 제한(실측 기준, 초과 시 오류 없이 전체 prompt가 무시됨, 중국어 약 11,000자)
`size`	`1024x1024` / `1536x1024` / `1024x1536` / `auto`
`quality`	`low` / `medium` / `high` / `auto` (2.5 시리즈에는 `xhigh` / `max` 추가됨)
`output_format`	`png` (기본값) / `jpeg` / `webp`
`output_compression`	JPEG/WebP 전용, 0–100%
`background`	`transparent` / `opaque` / `auto`
`n`	이미지 수 (1–10)

빠른 예시

from openai import OpenAI

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

response = client.images.generate(
    model="gpt-image-1.5",  {/* or gpt-image-1 / gpt-image-1-mini */}
    prompt="A professional product photo on white background, soft studio lighting",
    size="1024x1024",
    quality="high"
)

print(response.data[0].url)

이미지당 요금 참고

GPT-Image-1 / 1.5는 token 과금과 이미지당 과금을 모두 지원하며, 시스템이 더 저렴한 방식을 자동으로 선택합니다:

GPT-Image-1.5

품질	1024×1024	1024×1536 / 1536×1024
낮음	$0.009	$0.013
보통	$0.034	$0.050
높음	$0.133	$0.200

GPT-Image-1

품질	1024×1024	1024×1536 / 1536×1024
낮음	$0.005	$0.006
보통	$0.011	$0.015
높음	$0.036	$0.052

이미지당 수치는 참고용입니다. 실제 과금은 시스템이 더 저렴하다고 판단한 과금 방식(token 또는 이미지당)에 따릅니다.

이미지 편집 (`gpt-image-1` 전용)

gpt-image-1은 /v1/images/edits 엔드포인트를 통해 마스크 기반 편집을 지원합니다:

response = client.images.edit(
    model="gpt-image-1",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="A modern glass skyscraper with reflective windows",
    size="1024x1024"
)

매개변수	설명
`image`	원본 이미지, PNG/WebP/JPG, 각 50MB 미만, 최대 16개 이미지
`mask`	마스크 이미지 — alpha=0인 픽셀은 다시 그려집니다
`prompt`	마스크 영역에 생성할 내용에 대한 설명

새로운 편집 워크플로에는 GPT-Image-2 Edit (공식) 또는 GPT-Image-2-All Edit (리버스, 블렌딩을 위해 최대 16개의 입력 이미지를 지원함)을 사용합니다.

GPT-Image-2.5 / 2-All로 마이그레이션

요구 사항	권장 대상
공식 OpenAI 엔드포인트를 유지하면서 정밀한 크기/품질 제어가 필요한 경우	`gpt-image-2.5-flare` (텍스트 투 이미지) / `gpt-image-2.5-sunburst` (편집), 공식
예측 가능한 고정 요금($0.025/이미지)과 더 우수한 지시 준수 성능을 원하는 경우	`gpt-image-2-all` (리버스)
마스크 기반 이미지 편집이 여전히 필요한 경우	`gpt-image-2-all` 편집 엔드포인트(최대 16개 이미지)

GPT-Image-2.5 / 2 개요

현재 3종의 공식 모델 — 기존 버전과 호환되는 엔드포인트 및 파라미터

GPT-Image-2-All 개요

리버스 채널, 이미지당 $0.025 고정 요금, 더 빠른 처리 시간

공식 vs 리버스 비교

항목별 비교 및 선택 가이드

기초

기본 API

이미지 API (공식)

동영상 API (공식)

멀티모달 이해 API

텍스트 생성

음성 API (공식)

검색 및 안전

버전 라인업

공통 파라미터 (생성)

빠른 예시

이미지당 요금 참고

GPT-Image-1.5

GPT-Image-1

이미지 편집 (`gpt-image-1` 전용)

GPT-Image-2.5 / 2-All로 마이그레이션

GPT-Image-2.5 / 2 개요

GPT-Image-2-All 개요

공식 vs 리버스 비교

​버전 라인업

​공통 파라미터 (생성)

​빠른 예시

​이미지당 요금 참고

​GPT-Image-1.5

​GPT-Image-1

​이미지 편집 (gpt-image-1 전용)

​GPT-Image-2.5 / 2-All로 마이그레이션

GPT-Image-2.5 / 2 개요

GPT-Image-2-All 개요

공식 vs 리버스 비교

버전 라인업

공통 파라미터 (생성)

빠른 예시

이미지당 요금 참고

GPT-Image-1.5

GPT-Image-1

이미지 편집 (`gpt-image-1` 전용)

GPT-Image-2.5 / 2-All로 마이그레이션