GPT-Image-2.5-VIP 이미지 생성/편집

size 매개변수를 다시 사용할 수 있습니다 (업데이트 2026-07-22): size를 명시적으로 전달하면 이제 예상대로 출력 크기가 잠기며, 이 페이지의 30개 크기 참조 표도 다시 적용됩니다. 참고: size는 /v1/images/generations 및 /v1/images/edits 엔드포인트에서만 동작합니다 — /v1/chat/completions 채팅 엔드포인트는 size 매개변수를 지원하지 않으므로, 채팅 기반 이미지 생성에서는 크기를 잠글 수 없습니다. 최신 상태는 실시간 업데이트 섹션을 참조하십시오.

모든 이미지 API는 동기식입니다 — 폴링할 작업 ID가 없으며, 클라이언트가 연결을 끊으면 요청은 계속 과금되지만 결과는 사라집니다. 이 모델에는 넉넉한 타임아웃을 설정하십시오. Image API Essentials & Best Practices를 참조하십시오.

개요

gpt-image-2.5-vip(gpt-image-2.5-sunburst-vip의 별칭), gpt-image-2.5-flare-vip 및 이전 세대 gpt-image-2-vip는 APIYI의 Adobe 계열(Firefly) GPT 이미지 생성 역설계 모델입니다. 저품질 업스케일링이 아닌 고품질 GPT-Image 2.5 역설계 라인입니다. gpt-image-2.5-all과 동일한 고정 $0.03/이미지이며 요청/응답 형식도 동일합니다. 유일하게 중요한 차이점은 vip가 size 필드를 지원한다는 점으로, 4K를 포함한 **일반적인 크기 30개(가로세로 비율 10개 × 해상도 등급 3개: 1K 빠른 처리 / 2K 권장 / 4K 디테일)**를 제공합니다.

🎨 포지셔닝: 출력 크기를 고정해야 할 때(이커머스 히어로 이미지, 포스터 템플릿, 동영상 썸네일, 4K 배경화면 등) gpt-image-2.5-vip을 사용합니다. model 필드를 gpt-image-2.5-vip로 바꾸고 size 필드를 추가하기만 하면 됩니다. 나머지 코드는 모두 gpt-image-2.5-all과 동일하게 유지됩니다.

세 가지 -vip 모델은 하나의 제품군입니다: gpt-image-2.5-vip(gpt-image-2.5-sunburst-vip의 별칭), gpt-image-2.5-flare-vip 및 이전 세대 gpt-image-2-vip는 동일한 Adobe 역설계 라인을 공유하며, 가격($0.03/이미지, 호출당), 그룹(Default / image2_OSS / svip), 엔드포인트 및 호출 형식이 동일합니다. 전환하려면 model만 바꾸면 됩니다. flare-vip는 더 빠르고 부드러운 느낌을 제공하며, sunburst-vip는 더 높은 품질과 편집 정밀도를 제공하고 시각적으로 gpt-image-2-vip와 유사합니다. 매개변수 제한과 측정된 차이점은 아래의 “세 가지 -vip 모델 비교” 섹션에 나와 있습니다.

텍스트-이미지 API

/v1/images/generations — 텍스트 prompt와 명시적인 출력 크기를 지정하는 size입니다.

이미지 편집 API

/v1/images/edits — 편집/합성 지침과 함께 멀티파트 업로드를 사용합니다.

AI 에이전트가 통합을 수행하도록 하기

Codex / Claude Code / Cursor로 구축하는 경우 아래 prompt를 복사하여 에이전트에 전달하십시오. 먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 docs URL 끝에 .md 추가), 프로젝트에서 사용하는 자체 스택으로 코드를 작성합니다. timeout, base64 렌더링, 업로드 압축 및 30개의 유효한 size 값이 이미 요구 사항에 포함되어 있습니다.

코딩 에이전트를 사용하여 gpt-image-2.5-vip 시리즈의 텍스트-이미지 및 이미지 편집을 통합하거나 문제를 해결하십시오. Codex, Claude Code, Cursor 및 유사한 도구에 복사하여 붙여 넣으십시오.

이 prompt가 방지하는 문제

요구 사항	방지되는 함정
Timeout을 360초로 상향	주류 HTTP 클라이언트의 기본 timeout은 30~60초이므로 서버가 정상적으로 계속 생성 중인 동안에도 요청이 중단됩니다. 연결이 끊긴 요청에도 과금은 이루어집니다. 이미지 API 핵심 사항 및 모범 사례를 참조하십시오.
`response_format`을 명시적으로 전송	이전에 기본값이 변경된 적이 있으므로, 이를 지정하지 않으면 `url` 및 `b64_json` 형식을 모두 처리해야 합니다.
`size`를 30개 값으로 고정	표에 없는 값은 다른 크기로 다시 작성됩니다. 전각 곱셈 기호나 대문자 X는 유효하지 않습니다.
`quality`를 `high`까지 사용하고 `n`는 사용하지 않음	`xhigh` / `max`는 거부됩니다. 2.5 `high`는 `gpt-image-2-vip` `medium`일 때만 동일합니다. `n`를 3으로 설정하여 전송하면 이미지 3개에 대한 과금이 이루어지지만 1개만 반환됩니다.
429에서 `error.message` 읽기	거부된 매개변수와 업스트림 포화는 동일한 429 코드를 공유하지만 서로 다르게 처리해야 합니다.
업로드 전에 압축	휴대폰 사진은 일반적으로 4~5MB이며, 여기에 base64 인코딩으로 약 33%의 크기가 추가됩니다. 이미지 압축 및 출력 해상도를 참조하십시오.

`gpt-image-2-all` 대비 주요 차이점

gpt-image-2-vip과 gpt-image-2-all은 모두 역공학 기반 채널이며, 가격과 호출 코드는 동일합니다. 서로 대칭적으로 동작합니다 — 동일한 요청에서 model 필드만 바꾸면 동작이 대체로 동일합니다. 차이점은 다음과 같습니다.

구분	`gpt-image-2-all`	`gpt-image-2-vip`
채널	역공학 기반 ChatGPT 웹	역공학 기반 Adobe 제품군(Firefly)
가격	이미지당 $0.03	이미지당 $0.03 (모든 크기에서 동일)
`size` 매개변수	❌ 허용되지 않음 (prompt에서 설명)	✅ 4K를 포함한 30개 크기
4K(예: `3840x2160`)	❌	✅ 4K Detail 등급
생성 시간	약 30~60초	약 90~150초 (공식 `gpt-image-2`과 비슷한 수준)
`quality` 매개변수	❌ 허용되지 않음	✅ `auto` / `low` / `medium` / `high` (세 가지 -vip 모델 모두에서 측정된 결과이며 보장 사항은 아님); `xhigh` / `max` ❌
엔드포인트	`/images/generations` + `/images/edits`	왼쪽과 동일(동일함)
응답 형식	`b64_json` (기본값, 원시 base64, 접두사 없음) / `url` (`response_format` 명시)	왼쪽과 동일
적합한 용도	prompt 기반, 크기에 구애받지 않는 경우	출력 크기를 고정해야 하는 경우(4K 포함)

한 줄 결정: 엄격한 크기가 필요하지 않고 가장 빠른 출력을 원하는 경우 → gpt-image-2-all; 고정된 크기 또는 4K가 필요한 경우 → gpt-image-2-vip; quality 조절 옵션 또는 엄격한 OpenAI-API 필드 일치가 필요한 경우 → 공식 gpt-image-2을 사용합니다.

세 가지 -vip 모델 비교(측정일 2026-09-09)

동일한 채널과 token에서 모델 이름만 변경한 253회 요청의 3방향 비교와 26회의 직렬 경계 호출입니다. 계약은 셀 단위로 동일하며, 아래 행만 다릅니다. quality와 투명 배경은 과거에 gpt-image-2-vip에서 거부되었지만 이제 허용됩니다 — 채널 동작일 뿐 보장이 아니므로 실제 응답을 따르십시오.

항목	`gpt-image-2-vip`	`gpt-image-2.5-flare-vip`	`gpt-image-2.5-sunburst-vip`(별칭 `gpt-image-2.5-vip`)
포지셔닝	이전 세대이며 최고 token 등급 유지	2.5 속도 우선	2.5 품질 및 편집 우선
가격 / 그룹	이미지당, 호출당 $0.03; `Default` / `image2_OSS` / `svip`	동일	동일
`quality`	✅ `auto` / `low` / `medium` / `high`; `xhigh` / `max` ❌	동일	동일
출력 token(2048×1152)	low 157 / medium 1,413 / high 5,650	low 157 / medium 367 / high 1,413	flare-vip와 동일
등급 정렬	—	2.5 `high` = 2-vip `medium`; 가장 높은 2.5 등급은 2-vip `high`의 4분의 1	flare-vip와 동일
기본 `size`	2048×2048	1024×1536 세로형	2048×2048
사전 설정 크기 30개	30/30 픽셀 단위 정확 일치	30/30	30/30
사전 설정 외 `size`	오류 없음: 16의 배수는 그대로 통과하고, 그 외에는 16 단위로 정렬됨(`1920x1080` → 1920×1088). 크기가 부족하면 최소 변으로 올림(`512x512` → 816×816)	동일	동일
`mask`	⚠️ 허용되지만 전체 이미지 재생성; 실제 사진에서 3회 실행 시 내부/외부 변경 비율 ≈1	동일	동일
`background: "transparent"`	✅ 알파 PNG	✅ 단일 객체 prompt는 완전히 투명한 모서리 생성	✅ flare-vip와 동일
`output_format: "jpeg"`	조용히 무시되며 PNG 반환	동일	동일
`n`	이미지 1개를 반환하므로 보내지 마십시오	동일	동일
`response_format: "url"`	✅	✅	✅
편집 엔드포인트	단일 이미지는 입력 크기 유지, 여러 이미지는 첫 번째 이미지에 따름	동일	동일
품질(동일 크기 prompt 6개를 육안 비교)	기준	더 부드럽고 장식적 세부 묘사가 적음	2-vip에 가까움
1024² 지연 시간(직렬)	~90–150초	22–138초	37–120초

선택 방법: 일반적인 일상용 텍스트-이미지 변환에는 gpt-image-2.5-vip을 기본값으로 사용하고, 속도가 중요하면 gpt-image-2.5-flare-vip을 선택하며, 최고 token 등급은 high과 함께 gpt-image-2-vip를 선택하십시오. 세 모델 모두 정밀한 마스크 인페인팅을 수행하거나 xhigh / max를 허용하지 않으므로, 이러한 작업은 공식 GPT-Image-2.5 / 2로 보내십시오. 기본 크기는 이전에도 업스트림에서 변경된 적이 있으므로, 기본 크기를 고정하려면 항상 size을 명시적으로 전달하십시오.

핵심 기능

출력 크기 고정

size 필드는 30가지 일반 크기를 지원합니다 — 전자상거래 히어로 이미지, 포스터 템플릿, 4K 배경화면을 모두 정확한 픽셀로 출력합니다.

4K 고해상도

4K Detail 등급은 2880×2880 / 3840×2160 / 3840×1632 등을 지원하며, 대형 납품물에 적합합니다.

모든 크기에 동일한 요금

1K / 2K / 4K 모두 $0.03/이미지입니다 — 4K에 추가 요금이 없습니다.

-all과 동일한 호출 형식

요청 구조, 필드, 응답 형식은 gpt-image-2-all과 동일합니다 — model 문자열만으로 모델을 전환할 수 있습니다.

고품질 텍스트 렌더링

중국어/영문 텍스트, 간판, 포스터 문구를 안정적으로 렌더링합니다 — 인포그래픽과 마케팅 소재에 이상적입니다

중국어 Prompt 친화적

번역 없이 중국어 설명을 네이티브하게 이해합니다

자연어 편집

대화형 설명을 통해 편집하며, 마스크가 필요 없고, 다중 턴 반복을 지원합니다

표준 엔드포인트 지원

OpenAI Images API 표준 엔드포인트 /images/generations 및 /images/edits와 호환됩니다

가격

모델	과금	가격	출력
`gpt-image-2-vip`	호출당	$0.03 / 이미지	호출당 이미지 1개, `size` 필드가 출력 크기를 고정합니다
`gpt-image-2.5-flare-vip`	호출당	$0.03 / 이미지	GPT-Image 2.5 속도 우선, `-vip`와 동일한 파라미터 인터페이스(`quality` 최대 `high`)
`gpt-image-2.5-sunburst-vip` (별칭 `gpt-image-2.5-vip`)	호출당	$0.03 / 이미지	GPT-Image 2.5 품질 및 편집 우선, flare-vip와 동일한 파라미터 인터페이스

과금 참고 사항:

30개 모든 크기에 이미지당 $0.03의 정액 요금 적용 — 4K Detail에 대한 추가 요금 없음
실패한 요청에는 요금이 부과되지 않습니다(인증 실패, 파라미터 검증 오류)
이미지 N개가 필요한 경우 API를 N회 병렬로 호출합니다

그룹 설정

gpt-image-2-vip은 Default 그룹에 있습니다 — 추가 그룹이 필요하지 않습니다. 현재 역방향 채널은 안정적인 공급을 제공하므로, 공식 릴레이 gpt-image-2과 같은 엔터프라이즈 그룹 폴백 구성이 없습니다.

모델	그룹	참고
`gpt-image-2-vip`	`Default`	Adobe 역방향 라인(Firefly), 이미지당 고정 $0.03, 약 90~150초
`gpt-image-2-vip`	`image2_OSS`	1x 요율 배수(추가 요금 없음), 결정론적 URL 출력 — 기본 그룹에 부하가 걸려도 base64로 폴백되지 않음
`gpt-image-2.5-flare-vip` / `gpt-image-2.5-sunburst-vip` / `gpt-image-2.5-vip`	`Default` / `image2_OSS` / `svip`	`gpt-image-2-vip`과 정확히 동일한 그룹

결정론적 URL 출력이 필요하신가요? → `image2_OSS` 그룹으로 전환하십시오

2026년 7월 기본 그룹에서 측정한 결과, gpt-image-2-vip(및 gpt-image-2-all)은 response_format이 생략되면 b64_json을 반환합니다. 이미지 URL을 받으려면 response_format: "url"을 명시적으로 전달하십시오. 기본 그룹의 출력 형식은 보장되지 않습니다 — 과거에는 기본적으로 url을 사용하고 부하가 발생하면 b64_json로 폴백했으며, 채널 버전에 따라 변경된 적이 있습니다. 비즈니스가 URL 출력에 의존하는 경우(URL을 데이터베이스에 바로 기록하거나, URL로 프런트엔드에서 렌더링하거나, base64를 허용할 수 없는 경우) 토큰의 그룹을 **image2_OSS**로 전환하십시오 — 이 그룹은 결정론적 URL 출력을 목적으로 설계되었으며 **1x 요율 배수(추가 요금 없음)**가 적용되고, 두 역방향 모델 gpt-image-2-vip 및 gpt-image-2-all 모두에서 사용할 수 있습니다. 응답에 항상 이미지 URL이 포함되며 base64로 폴백되지 않음을 보장합니다.

토큰 생성 화면: 먼저 결제 모드는 종량제로 설정하고, 그룹은 image2_OSS(1x 요율 배수)로 설정합니다. 이미지 URL을 출력하는 그룹으로, gpt-image-2-all 및 gpt-image-2-vip에 적합합니다. — Token creation: set billing mode to "pay-as-you-go first" and pick the image2_OSS group (1x) — use it when you need deterministic URL output

고급 설정(gpt-image-2-all 및 공식 릴레이 gpt-image-2도 함께 사용하는 경우): 토큰이 세 모델을 모두 지원한다면 토큰의 그룹 우선순위를 다음과 같이 설정하십시오.

첫 번째 우선순위: image2Enterprise(1.2x 엔터프라이즈 그룹, 공식 릴레이 전용 안정적 라인)
기본 폴백: Default(두 역방향 모델이 모두 이곳에 있으며 모델에 따라 라우팅됨)

결과적으로 공식 릴레이 gpt-image-2은 안정성을 위해 엔터프라이즈 라인을 사용하고, 두 역방향 모델은 기본 그룹에 유지됩니다 — 하나의 토큰으로 세 모델을 모두 지원하며 서로 간섭하지 않습니다.

📖 image2Enterprise 그룹 정보: /en/live/2026-04/image2-enterprise-stable

기술 사양

속성	값
모델 이름	`gpt-image-2-vip`; 2.5 버전 `gpt-image-2.5-flare-vip` / `gpt-image-2.5-sunburst-vip`(별칭 `gpt-image-2.5-vip`)
채널 유형	공식 리버스 엔지니어링(Adobe 제품군, Firefly)
가격	이미지당 $0.03, 호출당(모든 크기 동일 정액)
생성 시간	`gpt-image-2-vip` 약 90~150초; 2.5 모델은 순차 실행에서 1024² 기준 22~140초로 측정되었으며 편차가 큽니다. 500 RPM 이내에서는 동시 실행 수를 계획할 필요가 없습니다. `429`을 받았다면 먼저 `error.message`을 확인하십시오. 거부된 매개변수(`quality must be one of…`)라면 매개변수만 수정하면 됩니다. `当前分组上游负载已饱和`(상위 서비스 포화)은 간헐적으로 발생하므로 백오프로 재시도하거나, 지원팀에 모델 상태를 문의하거나, 실시간 업데이트를 확인하십시오
`size` 매개변수	✅ 30개 크기: 10개 비율 × 3개 해상도 등급(1K 빠른 처리 / 2K 권장 / 4K 디테일)
4K 지원	✅ 4K 디테일 등급(예: `3840x2160` / `2880x2880`)
`quality` 매개변수	세 가지 모두 ✅ `auto` / `low` / `medium` / `high`(2026-09-09 측정, 채널 동작이며 보장 사항이 아님); `xhigh` / `max` ❌; 동일한 등급 이름은 2.5에서 token 수가 한 단계 낮습니다(위 표 참조)
`mask` 매개변수	⚠️ 세 가지 모두 허용되지만 마스크 영역만 수정한다고 보장되지 않습니다(실제 사진에서 전체 이미지 재생성 측정). 정밀한 인페인팅에는 공식 모델을 사용하십시오
투명 배경	✅ 세 가지 모두 `background: "transparent"`에 대해 알파 PNG를 반환합니다(보장 사항이 아님)
기본 `size`	`gpt-image-2-vip` / sunburst-vip 2048×2048, flare-vip 1024×1536; 상위 서비스에 따라 변경되므로 실제 응답을 따르십시오
`n` 매개변수	❌ 지원되지 않으며, 호출당 이미지 1개입니다
기본 응답 형식	`b64_json`(원시 base64, `data:` 접두사 없음, 2026-07 검증됨; 항상 `response_format`을 명시적으로 전달하십시오)
선택적 형식	`url`(R2 CDN 가속 링크, 유효 기간 약 1일, `response_format: "url"`을 명시적으로 지정해야 함)
중국어 prompt	✅ 기본 지원
기능	텍스트-이미지 변환, 단일 이미지 편집, 다중 이미지 융합, 자연어 편집

⏰ 이미지 URL 유효 기간: 약 1일(기본값)url 모드 응답의 url 필드는 약 24시간 후 만료되는 R2 CDN 링크입니다. 그 이후의 요청은 404를 반환합니다. 장기 보존이 필요한 이미지는 생성 후 가능한 한 빨리 자체 저장소에 다운로드하여 보존하거나 b64_json 응답 형식을 사용하십시오.

엔드포인트

gpt-image-2-vip는 gpt-image-2-all와 완전히 동일한 두 엔드포인트와 호환됩니다. 필요하면 model 필드만 바꾸고 size를 추가하면 됩니다:

엔드포인트	용도	Content-Type	가장 적합한 경우
`POST /v1/images/generations`	텍스트-이미지	`application/json`	OpenAI Images API 표준 형식 — 동일한 코드로 공식 채널과 리버스 채널 모두를 호출할 수 있습니다
`POST /v1/images/edits`	이미지 편집(단일/다중)	`multipart/form-data`	OpenAI Images API 표준 형식 — 동일한 코드로 공식 채널과 리버스 채널 모두를 호출할 수 있습니다

OpenAI Images API를 사용하십시오 (/v1/images/generations + /v1/images/edits), 이유는 두 가지입니다:

더 안정적입니다: Images API 채널의 상위 리소스 공급이 더 풍부하므로 호출 성공률이 더 높습니다
공식 릴레이와 호환되어 전환이 쉽습니다: 호출 방식과 size 같은 파라미터가 공식 릴레이 gpt-image-2와 완전히 호환됩니다 — 리버스 채널이 리스크 제어에 걸려 불안정해지면 model 이름만 바꾸면 코드 변경 없이 그대로 사용할 수 있습니다

채팅 기반 엔드포인트(/v1/chat/completions, 더 이상 권장되지 않음)도 있습니다 — 아래 FAQ를 참고하십시오.

도메인 옵션: api.apiyi.com이 메인 도메인입니다. b.apiyi.com / vip.apiyi.com 같은 대체 게이트웨이 도메인도 사용할 수 있습니다. 응답 동작은 동일합니다.

지원 크기 (전체 30개 크기 표)

gpt-image-2-vip은 가로세로 비율 10개 × 해상도 등급 3개 = 총 30개 크기를 지원합니다. 요청 본문에 size: "WIDTHxHEIGHT"(소문자 ASCII x)를 직접 전달합니다.

1K 빠른 처리 — 초안 및 저비용 반복 작업

비율	이름	픽셀
1:1	정사각형	`1280x1280`
2:3	세로형	`848x1280`
3:2	사진	`1280x848`
3:4	세로형	`960x1280`
4:3	표준	`1280x960`
4:5	소셜	`1024x1280`
5:4	대형	`1280x1024`
9:16	스토리	`720x1280`
16:9	와이드	`1280x720`
21:9	시네마	`1280x544`

2K 권장 — 기본 등급 (대부분의 프로덕션 출력)

비율	이름	픽셀
1:1	정사각형	`2048x2048`
2:3	세로형	`1360x2048`
3:2	사진	`2048x1360`
3:4	세로형	`1536x2048`
4:3	표준	`2048x1536`
4:5	소셜	`1632x2048`
5:4	대형	`2048x1632`
9:16	스토리	`1152x2048`
16:9	와이드	`2048x1152`
21:9	시네마	`2048x864`

4K 상세 — 대형 결과물

비율	이름	픽셀
1:1	정사각형	`2880x2880`
2:3	세로형	`2336x3520`
3:2	사진	`3520x2336`
3:4	세로형	`2480x3312`
4:3	표준	`3312x2480`
4:5	소셜	`2560x3216`
5:4	대형	`3216x2560`
9:16	스토리	`2160x3840`
16:9	와이드	`3840x2160`
21:9	시네마	`3840x1632`

전체 30개 크기에 동일한 가격 적용: 이미지당 $0.03입니다. 4K 상세에는 추가 요금이 없습니다.

등급 선택:

1K 빠른 처리 — 초안, 썸네일, A/B 테스트에 적합합니다. 가장 빠르게 출력됩니다(가격은 동일하지만 반복 작업 주기가 더 짧습니다).
2K 권장 — 기본 등급입니다. 대부분의 프로덕션 출력(이커머스 히어로 샷, 포스터, 인포그래픽)을 지원합니다.
4K 상세 — 인쇄물, 대형 디스플레이, 동영상 썸네일, 데스크톱 / 옥외 대형 포맷에 적합합니다.

최소 호출 예시 (size만 전달하고, quality은 전달하지 마십시오):

curl "https://api.apiyi.com/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YI_API_KEY" \
  -d '{
    "model": "gpt-image-2.5-vip",
    "prompt": "Product shot of a white ceramic mug on a gray desk, soft natural light, clean background",
    "size": "2048x1360"
  }'

모범 사례

입력 이미지를 1.5MB 미만으로 압축합니다(이미지 편집 / 다중 이미지 융합)

업로드하는 각 이미지를 1.5MB 미만으로 압축합니다(JPEG 품질 80~90 / 해상도 축소). 다중 이미지 융합에서도 이미지마다 동일한 상한을 적용합니다. 간헐적인 shell_api_error / Unknown error 응답은 대부분 지나치게 큰 입력으로 인해 발생하므로, 압축하면 성공률과 지연 시간이 눈에 띄게 개선됩니다. 출력 해상도는 입력 크기가 아니라 size 필드로 결정됩니다 — 입력을 축소하면 처리 속도만 빨라질 뿐 품질에는 영향을 주지 않습니다. 프롬프트에 4K / 8K을 반복해서 넣어도 4K 이미지가 생성되지는 않습니다. 해상도는 프롬프트의 불필요한 설명이 아니라 size로 설정됩니다.

결과물에 따라 크기 등급을 선택합니다

초안에는 1K Fast, 프로덕션에는 2K Recommended, 인쇄물/대형 디스플레이에는 4K Detail을 사용합니다. 가격은 정액이므로 필요에 따라 선택합니다.

크기에는 소문자 ASCII x를 사용합니다

"size": "1536x1024"를 전송합니다 — 1536×1024도 아니고 대문자 X도 아닙니다.

quality는 high까지 지원하며 n은 전달하지 않습니다

세 가지 -vip 모델 모두 테스트에서 auto / low / medium / high를 허용합니다(보장 사항은 아닙니다. 2.5 high은 gpt-image-2-vip medium과 같을 때만 해당함). xhigh / max은 거부됩니다. n은 호출마다 항상 이미지 1개를 반환하므로 여러 이미지가 필요하면 병렬로 호출합니다.

타임아웃을 300초로 설정합니다

일반적인 생성 시간은 90~150초이지만 이미지 업로드/다운로드 시간과 피크 시간대의 꼬리 지연으로 더 길어질 수 있습니다. 보수적인 기본값으로 300초를 설정합니다.

필요에 따라 응답 형식을 선택합니다

웹에서 직접 렌더링하려면 b64_json를 사용하고, 서버 측 저장/전달에는 url를 사용합니다.

-all과 코드를 공유합니다

동일한 코드가 두 경우 모두 작동합니다 — 필요에 따라 model를 gpt-image-2-all와 gpt-image-2-vip 사이에서 전환합니다. 크기를 고정해야 할 때는 vip를 사용하고, 가장 빠르게 반복 작업을 진행하려면 -all로 다시 전환합니다.

오류 코드 및 재시도

상태	의미	제안
`400`	30개 크기 세트에 없는 크기이거나 형식이 잘못됨	위 표의 문자열을 정확히 사용합니다
`401`	유효하지 않은 token	Bearer 토큰을 확인합니다
`429`	거부된 매개변수 / 간헐적인 업스트림 포화 / 쿼터 소진	500 RPM 이내에서는 동시 실행 수 계획이 필요하지 않습니다. `429`가 발생하면 먼저 `error.message`을 읽습니다. 거부된 매개변수(`quality must be one of…`)는 매개변수만 수정하면 되며, `当前分组上游负载已饱和`(업스트림 포화)은 간헐적으로 발생하므로 백오프로 재시도하거나 지원팀에 모델 상태를 문의하거나 실시간 업데이트를 확인합니다
`500` (4K 간헐적 발생)	OpenAI 업스트림 컴퓨팅 변동이며, 4K 상세 등급에서 더 자주 발생함	권장 2K로 낮추고 재시도합니다. 4K가 필수인 경우 공식 프록시 `gpt-image-2` + `image2Enterprise` 그룹으로 전환합니다
`5xx` (기타)	일시적인 게이트웨이/백엔드 오류	1~2회 재시도합니다
시간 초과	업스트림 피크 + 4K 롱테일	클라이언트 시간 초과를 300초 이상으로 설정합니다(보수적 설정)

클라이언트 권장 사항:

요청 시간 초과를 300초부터 시작하도록 설정합니다(보수적 설정이며, 일반적으로 90~150초이지만 4K 상세 등급 및 피크 롱테일에서는 더 길어질 수 있음)
5xx 및 시간 초과에 지수 백오프를 사용합니다(2~3회 재시도 권장)
디버깅을 위해 request-id 응답 헤더를 기록합니다

FAQ

vip와 -all 간에 코드를 공유할 수 있습니까?

예, 거의 동일합니다. 두 엔드포인트(/v1/images/generations, /v1/images/edits)는 요청 필드, 응답 필드 및 b64_json 접두사 동작을 공유합니다. 차이점은 다음과 같습니다.

model 필드: gpt-image-2-vip ↔ gpt-image-2-all
size 필드: vip는 30개 크기 세트를 허용하지만, -all은 size을 거부합니다(대신 크기를 prompt에 입력합니다).

실용적인 방식은 if model == 'vip': payload['size'] = ... 스위치를 사용하여 하나의 코드베이스를 유지하는 것입니다.

vip는 왜 훨씬 느립니까?

gpt-image-2-vip은 Adobe 역방향 채널(Firefly)을 사용하므로 일반적으로 90~150초가 걸립니다. 이는 공식 gpt-image-2(100~~120초)와 비슷하며 ChatGPT-web-line gpt-image-2-all(30~~60초)보다 느립니다. 지연 시간에 민감한 워크로드에는 gpt-image-2-all을 우선 사용하고, 고정된 크기 또는 4K가 필요한 경우에만 vip로 전환하십시오.

크기는 반드시 표에 있는 값이어야 합니까? 1024x768을 보내면 어떻게 됩니까?

30개 크기 세트를 사용하십시오. 2026-09-09 테스트 기준으로 목록에 없는 크기도 더 이상 오류가 발생하지 않지만, 생성 전에 다음과 같이 다시 작성됩니다. 16의 배수는 그대로 전달되고(1024x1024 / 1600x1600), 그 외의 값은 16 단위로 정렬되며(1920x1080 → 1920×1088), 너무 작은 값은 최소 변의 크기까지 올림 처리됩니다(512x512 → 816×816). 요청한 크기와 다른 이미지가 반환될 수 있으므로, 정확한 크기가 중요할 때는 30개 프리셋을 사용하십시오.

4K에서 500 오류가 자주 반환되는 이유는 무엇입니까? 안정적으로 4K를 얻으려면 어떻게 해야 합니까?

증상: 4K Detail 등급(예: 3840x2160 / 2880x2880)에서는 status_code: 500 오류가 더 쉽게 발생하며, 업스트림에서 다음을 반환합니다(invalid_request_error):

{
  "status_code": 500,
  "error": {
    "message": "An error occurred while processing your request. ... Please include the request ID xxxxxxxx in your message.",
    "type": "invalid_request_error",
    "code": null
  }
}

근본 원인: OpenAI 컴퓨팅 변동이며, 요청 매개변수의 문제가 아닙니다. 동일한 페이로드는 일반적으로 2K에서 정상적으로 처리됩니다. 역방향 채널은 대규모 출력인 4K에 더 민감하며, 특히 사용량이 많은 시간대에 그렇습니다.완화 방법(비용 대비 효과순):

2K Recommended를 우선 사용하십시오(예: 2048x1360 / 2048x2048). 성공률이 크게 높고 이미지당 $0.03으로 동일합니다.
img2img / 다중 이미지 융합에서는 입력 이미지 수를 줄이십시오. 역방향 채널은 입력 부하가 높을 때 처리가 어려워져 4K 실패율이 더욱 높아집니다. 각 입력 이미지를 1.5MB 미만으로 사전 압축하는 것도 도움이 됩니다.
보장된 4K가 필요한 경우 공식 프록시 gpt-image-2 + image2Enterprise 그룹으로 전환하십시오. 공식 프록시의 4K는 더 비싸지만(이미지당 ~$0.3+), 훨씬 안정적이므로 4K 제공이 필수인 경우에 적합합니다.

📖 현장 참고 사항: /en/live/2026-05/gpt-image-2-vip-4k-tips

입력 이미지를 압축해야 합니까? prompt에 4K / 8K를 입력하면 도움이 됩니까?

예, 강력히 권장합니다. 각 입력 이미지를 1.5MB 미만으로 압축하십시오(JPEG 품질 80~90 / 해상도 축소). 간헐적인 shell_api_error / Unknown error 응답은 대부분 지나치게 큰 입력으로 인해 발생하며, 압축하면 성공률과 지연 시간이 눈에 띄게 개선됩니다. 참고로 1.5MB는 안정성과 속도를 위한 권장 상한이며, 위 FAQ의 10MB는 게이트웨이의 하드 제한입니다.압축으로 품질이 저하될까 걱정하지 않아도 됩니다. 출력 해상도는 입력 크기가 아니라 size 매개변수에 의해 결정됩니다. 입력 크기를 줄이면 처리 속도만 빨라집니다.prompt에 4K / 8K를 입력해도 실제로 4K 출력이 생성되지는 않습니다. prompt에 8K ultra HD라고 입력했지만 size을 1024x1024로 설정하면 여전히 1K 품질의 이미지를 받습니다. 4K를 사용하려면 size 필드에서 설정하십시오. 1K / 2K / 4K는 30개 크기 세트 전체에서 모두 이미지당 고정 $0.03으로 동일합니다.📖 출처: /en/live/2026-05/gpt-image-2-vip-unknown-error

4K에 정말 추가 요금이 없습니까?

추가 요금이 없습니다. 4K Detail 등급(3840x2160 / 2880x2880 등)은 1K 및 2K와 동일하게 이미지당 $0.03입니다.

n을 지원합니까? n=3을 전달하면 어떻게 됩니까?

지원하지 않습니다. 이 모델은 호출당 이미지 1개를 반환하므로, 여러 이미지가 필요하면 호출을 반복하거나 동시에 실행하십시오.⚠️ 중요: 요청에 n=3을 전달하면 과금은 0.03 × 3 = $0.09가 되지만, 실제로 반환되는 이미지는 1개뿐입니다. 불필요한 요금을 피하려면 n 필드를 제거하십시오.

콘텐츠가 거부되거나 모델이 ‘요청을 처리할 수 없습니다’라고 답하면 과금됩니까?

이는 동기식 채팅 스타일 응답을 사용하는 역공학된 채널입니다. 결과는 서로 다른 과금 규칙이 적용되는 두 가지 경우로 나뉩니다.1) HTTP 5xx 반환 → 과금되지 않음업스트림 콘텐츠 정책이 요청을 강제로 차단하면 다음과 같은 응답을 볼 수 있습니다.

{
  "error": {
    "message": "Image was not generated as expected. Please adjust the prompt and retry (traceid: 0672821c6951af183dbf847130caaf16)",
    "localized_message": "Unknown error",
    "type": "invalid_request_error",
    "param": "",
    "code": null
  }
}

이러한 하드 오류에는 과금되지 않습니다. 사용자에게 prompt를 조정한 후 다시 시도하도록 안내하십시오.2) 텍스트 형식의 “소프트 거부”와 함께 HTTP 200 반환 → 과금됨모델이 대화 내에서 소프트 거부하는 경우(예: “요청을 처리할 수 없습니다”, “죄송합니다. 이 요청에는…”), 프로토콜 수준에서는 일반적인 채팅 완성 응답처럼 보이므로 과금됩니다. 역방향 채널은 프로토콜 계층에서 “거부 텍스트”와 “이미지 출력”을 안정적으로 구분할 수 없습니다.소프트 거부에 대해 일괄적으로 면제할 수 없는 이유모든 소프트 거부를 자동으로 면제하면 플랫폼이 실패한 모든 업스트림 호출 비용을 부담하게 됩니다. 더 중요한 점은 업스트림 콘텐츠 안전 정책을 반복적으로 트리거하면 공급업체 계정이 정지될 위험도 높아진다는 것입니다. 이는 완전히 제거할 수 없는 실제 공급 측 비용입니다.통합 개발자를 위한 권장 사항

✅ 소비자용 제품의 월별 환급: 소비자 대상 제품에서는 사용자 입력을 완전히 제한하기 어렵다는 점을 이해합니다. 월간 지출이 충분히 큰 경우(월 $1000 이상), 로그를 매월 일괄 정리하여(지연 시간이 짧은 호출은 대개 소프트 거부입니다) 지원팀에 일회성 수동 크레딧을 문의할 수 있습니다. 호출별 이의 제기를 제출할 필요는 없습니다.

b64_json에 data:image/png;base64, 접두사를 추가해야 합니까?

먼저 감지한 후 처리하십시오. 2026년 7월 검증 결과, 반환된 b64_json은 data: 접두사가 없는 원시 base64입니다. 이를 디코딩하여 파일로 저장하거나, 렌더링하기 전에 직접 접두사를 추가하십시오. 단, 이전 버전에는 접두사가 포함되어 있었습니다. 코드에 startsWith('data:') 검사를 추가하십시오. 접두사가 있으면 값을 그대로 img src로 사용하고, 없으면 먼저 디코딩하거나 접두사를 추가하십시오. 이렇게 하면 접두사가 중복으로 추가되거나 접두사가 포함된 문자열을 디코딩하여 이미지가 손상되는 문제를 방지할 수 있습니다.

참조 이미지의 최대 크기와 지원 형식은 무엇입니까?

이미지당 10MB 이하를 권장하며, 지원 형식은 png / jpg / webp입니다. 지나치게 큰 이미지는 게이트웨이 제한에 걸릴 수 있습니다. 다중 이미지 융합에서 각 이미지는 이 제한을 충족해야 합니다.

반환된 이미지 URL은 얼마나 오래 유효합니까? 다운로드해야 합니까?

url-mode 응답의 url 필드는 약 1일(24시간) 후 만료되는 R2 CDN 링크이므로, 그 이후의 요청은 404를 반환합니다.강력히 권장합니다: 생성 직후 생성된 이미지를 자체 오브젝트 스토리지(S3 / OSS / R2), CDN 또는 데이터베이스에 다운로드하여 보관하십시오.

스트리밍을 지원합니까?

지원하지 않습니다. 이 모델은 이미지를 한 번에 반환하며 스트리밍은 지원되지 않습니다. 지연 시간이 중요한 경우 클라이언트 측에 “생성 중…” 진행 표시기를 표시하고 300초 타임아웃을 보수적으로 설정하십시오.

공식 OpenAI SDK를 사용할 수 있습니까?

예. base_url을 https://api.apiyi.com/v1로 지정하고 api_key을 APIYI token으로 설정하십시오. client.images.generate(model="gpt-image-2.5-vip", size="2048x1360", prompt=...)은 직접 작동합니다.

여전히 /v1/chat/completions를 통해 이미지를 생성할 수 있습니까?

예. 엔드포인트는 여전히 작동하지만 더 이상 권장되지 않습니다. 대신 /v1/images/generations 및 /v1/images/edits을 사용하십시오. 더 안정적이며 동일한 코드가 공식 릴레이 gpt-image-2에서도 작동합니다.채팅 기반 방식은 다중 턴 반복 편집 또는 온라인 이미지 URL을 직접 전달하는 두 가지 경우에만 적합합니다. 이미지 의도가 모호하면 모델이 이미지 대신 일반 텍스트를 반환할 수 있습니다. 이를 방지하려면 prompt에 “이미지 생성:”과 같은 고정 접두사를 추가하여 이미지 생성 의도를 명확히 하십시오.전체 매개변수는 채팅 기반 API 레퍼런스를 참조하십시오.

공식 gpt-image-2로 전환해야 하는 시점은 언제입니까?

xhigh / max 품질 등급, 정밀한 마스크 인페인팅 또는 OpenAI-API 필드와의 엄격한 호환성이 필요하면 공식 gpt-image-2.5-flare / sunburst / gpt-image-2을 사용하십시오. 공식 버전과 역방향 버전 비교를 참조하십시오.

기초

기본 API

이미지 API (공식)

동영상 API (공식)

멀티모달 이해 API

텍스트 생성

음성 API (공식)

검색 및 안전

GPT-Image-2.5-VIP 이미지 생성/편집

개요

텍스트-이미지 API

이미지 편집 API

AI 에이전트가 통합을 수행하도록 하기

`gpt-image-2-all` 대비 주요 차이점

세 가지 -vip 모델 비교(측정일 2026-09-09)

핵심 기능

출력 크기 고정

4K 고해상도

모든 크기에 동일한 요금

-all과 동일한 호출 형식

고품질 텍스트 렌더링

중국어 Prompt 친화적

자연어 편집

표준 엔드포인트 지원

가격

그룹 설정

결정론적 URL 출력이 필요하신가요? → `image2_OSS` 그룹으로 전환하십시오

기술 사양

엔드포인트

지원 크기 (전체 30개 크기 표)

1K 빠른 처리 — 초안 및 저비용 반복 작업

2K 권장 — 기본 등급 (대부분의 프로덕션 출력)

4K 상세 — 대형 결과물

모범 사례

오류 코드 및 재시도

FAQ

관련 문서

​개요

텍스트-이미지 API

이미지 편집 API

​AI 에이전트가 통합을 수행하도록 하기

​gpt-image-2-all 대비 주요 차이점

​세 가지 -vip 모델 비교(측정일 2026-09-09)

​핵심 기능

출력 크기 고정

4K 고해상도

모든 크기에 동일한 요금

-all과 동일한 호출 형식

고품질 텍스트 렌더링

중국어 Prompt 친화적

자연어 편집

표준 엔드포인트 지원

​가격

​그룹 설정

​결정론적 URL 출력이 필요하신가요? → image2_OSS 그룹으로 전환하십시오

​기술 사양

​엔드포인트

​지원 크기 (전체 30개 크기 표)

​1K 빠른 처리 — 초안 및 저비용 반복 작업

​2K 권장 — 기본 등급 (대부분의 프로덕션 출력)

​4K 상세 — 대형 결과물

​모범 사례

​오류 코드 및 재시도

​FAQ

​관련 문서

개요

AI 에이전트가 통합을 수행하도록 하기

`gpt-image-2-all` 대비 주요 차이점

세 가지 -vip 모델 비교(측정일 2026-09-09)

핵심 기능

가격

그룹 설정

결정론적 URL 출력이 필요하신가요? → `image2_OSS` 그룹으로 전환하십시오

기술 사양

엔드포인트

지원 크기 (전체 30개 크기 표)

1K 빠른 처리 — 초안 및 저비용 반복 작업

2K 권장 — 기본 등급 (대부분의 프로덕션 출력)

4K 상세 — 대형 결과물

모범 사례

오류 코드 및 재시도

FAQ

관련 문서