GPT-Image-2-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-vip은 Codex 라인의 GPT 이미지 생성 역공학 모델이며, APIYI 플랫폼에서 사용할 수 있습니다. gpt-image-2-all와 동일한 정액 $0.03/image이며 요청/응답 형식도 동일합니다. 단 하나의 의미 있는 차이는 vip가 size 필드를 **30개의 공통 크기(10개 가로세로 비율 × 3개 해상도 계층: 1K Fast / 2K Recommended / 4K Detail)**와 함께 지원한다는 점이며, 여기에는 4K도 포함됩니다.

🎨 포지셔닝: 출력 크기를 고정해야 할 때 gpt-image-2-vip를 사용합니다(이커머스 히어로 샷, 포스터 템플릿, 동영상 썸네일, 4K 월페이퍼 등). model 필드를 gpt-image-2-vip로 바꾸고 size 필드를 추가하기만 하면 되며, 나머지 코드 줄은 모두 gpt-image-2-all와 동일합니다.

Text-to-Image API

/v1/images/generations — 명시적인 출력 차원을 위한 텍스트 prompt + size입니다.

Image Editing API

/v1/images/edits — 편집/융합 지침이 포함된 multipart 업로드입니다.

`gpt-image-2-all`과의 주요 차이점

gpt-image-2-vip과 gpt-image-2-all는 둘 다 역공학된 채널이며, 가격도 같고 호출 코드도 같습니다. 서로를 그대로 반영합니다 — 같은 요청에서 model 필드만 바꾸면 동작은 대체로 동일합니다. 차이점은 다음과 같습니다:

항목	`gpt-image-2-all`	`gpt-image-2-vip`
채널	역공학된 ChatGPT 웹	역공학된 Codex 라인
가격	$0.03 / image	$0.03 / image (모든 크기에서 동일)
`size` 매개변수	❌ 허용되지 않음(prompt에 설명)	✅ 4K를 포함한 30개 크기
4K (예: `3840x2160`)	❌	✅ 4K Detail 등급
생성 시간	약 30~60초	약 90~150초(공식 `gpt-image-2`와 동급)
`quality` 매개변수	❌ 허용되지 않음	❌ 허용되지 않음(전달하지 마십시오)
엔드포인트	`/images/generations` + `/images/edits`	왼쪽과 동일(완전 동일)
응답 형식	`b64_json`(기본값, 원시 base64, 접두사 없음) / `url`(명시적 `response_format`)	왼쪽과 동일
적합한 용도	프롬프트 중심, 크기에 구애받지 않음	고정된 출력 크기 필요(4K 포함)

한 줄 판단: 엄격한 크기 고정은 필요 없고 가장 빠른 출력을 원하면 → gpt-image-2-all; 고정 크기나 4K가 필요하면 → gpt-image-2-vip; quality 조절 옵션이나 OpenAI API 필드와의 엄격한 일치가 필요하면 → 공식 gpt-image-2을 사용하십시오.

핵심 기능

출력 크기 고정

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` 필드가 출력 크기를 고정합니다

과금 참고 사항:

모든 30개 크기에 대해 이미지당 $0.03 정액 — 4K Detail에 추가 요금이 없습니다
실패한 요청은 과금되지 않습니다(인증 실패, 매개변수 검증 오류)
N개의 이미지를 처리하려면 API를 N번 병렬로 호출하십시오

그룹 설정

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

모델	그룹	비고
`gpt-image-2-vip`	`Default`	Codex 역방향 라인, 고정 $0.03/img, 약 90–150초
`gpt-image-2-vip`	`image2_OSS`	1배 요율 배수(추가 요금 없음), 결정적인 URL 출력 — 기본 그룹이 과부하일 때도 base64로 폴백하지 않습니다

결정적인 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는 허용되지 않는 경우), token의 그룹을 **image2_OSS**로 변경하십시오 — 결정적인 URL 출력을 위해 특별히 설계된, **1배 요율 배수(추가 요금 없음)**의 그룹이며, 역방향 모델 gpt-image-2-vip 및 gpt-image-2-all 모두에 적용됩니다. 응답에 항상 이미지 URL이 포함되며 base64로 폴백하지 않습니다.

Token 생성 화면: 과금 모드는 먼저 사용량 기반 과금, group image2_OSS (1배 요율 배수), 이미지 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도 함께 사용하는 경우): token이 세 모델을 모두 커버한다면, token의 group 우선순위를 다음과 같이 설정하십시오:

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

결과: 공식 릴레이 gpt-image-2는 안정성을 위해 엔터프라이즈 경로를 이용하고, 두 역방향 모델은 기본 그룹에 유지되므로 — 하나의 token으로 세 모델을 모두 커버하고, 간섭이 없습니다.

📖 image2Enterprise 그룹 소개: /en/live/2026-04/image2-enterprise-stable

기술 사양

Attribute	Value
모델 이름	`gpt-image-2-vip`
채널 유형	공식 역공학 기반(Codex 라인)
가격	$0.03 / image, 호출당(모든 크기에서 동일)
생성 시간	~90–150 seconds (공식 `gpt-image-2`와 비슷하며, `gpt-image-2-all`의 30–60s보다 느립니다)
`size` 매개변수	✅ 30가지 크기: 10개 비율 × 3개 해상도 티어(1K 빠름 / 2K 권장 / 4K 상세)
4K 지원	✅ 4K 상세 티어(예: `3840x2160` / `2880x2880`)
`quality` 매개변수	❌ 지원되지 않으므로 전달하지 마십시오
`n` 매개변수	❌ 지원되지 않으며, 호출당 단일 이미지입니다
기본 응답 형식	`b64_json`(raw base64, `data:` 접두사 없음, 2026-07 검증됨; 항상 `response_format`를 명시적으로 전달해야 함)
선택적 형식	`url`(R2 CDN 가속 링크, 약 1일 유효, 명시적인 `response_format: "url"` 필요)
중국어 prompt	✅ 네이티브로 지원됩니다
기능	Text-to-image, 단일 이미지 편집, 다중 이미지 융합, 자연어 편집

⏰ 이미지 URL 유효 기간: 약 1일(기본값)url 필드는 url 모드 응답의 R2 CDN 링크이며, 약 24시간 후 만료됩니다 — 그 이후의 요청은 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 Fast — 초안 및 저비용 반복 작업

비율	이름	픽셀
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 Recommended — 기본 티어(대부분의 프로덕션 출력)

비율	이름	픽셀
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 Detail — 대형 산출물

비율	이름	픽셀
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 Detail에는 추가 요금이 없습니다.

티어 선택:

1K Fast — 초안, 썸네일, A/B 테스트에 적합합니다. 출력이 가장 빠릅니다(과금은 정액이지만 반복 주기가 더 짧습니다).
2K Recommended — 기본 티어입니다. 대부분의 프로덕션 출력(이커머스 히어로 샷, 포스터, 인포그래픽)을 커버합니다.
4K Detail — 인쇄, 대형 디스플레이, 동영상 썸네일, 데스크톱 / 옥외 대형 포맷에 적합합니다.

최소 호출 예시 (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-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는 프로덕션용으로 권장됩니다. 4K는 인쇄/대형 디스플레이용 세부 모드입니다. 과금은 동일합니다 — 필요에 따라 선택하십시오.

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

"size": "1536x1024"를 보내십시오 — 1536×1024가 아니며, 대문자 X도 아닙니다.

quality 또는 n을 전달하지 마십시오

quality는 거부됩니다. n는 호출당 1개 이미지만 반환하므로, 여러 이미지는 병렬로 호출하십시오.

300s 타임아웃을 사용합니다

일반적인 생성 시간은 90–150s이지만, 이미지 업로드 / 다운로드 시간과 피크-테일 지연이 이를 더 늘립니다. 보수적인 기준선으로 300s를 설정하십시오.

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

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

-all로 코드를 공유합니다

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

오류 코드 및 재시도

Status	의미	제안
`400`	30-size 세트에 없거나 형식이 잘못됨	위 표의 정확한 문자열을 사용하십시오
`401`	잘못된 token	Bearer Token을 확인하십시오
`429`	요청 제한 / 쿼터 소진	지수 백오프 재시도
`500` (4K 간헐적)	OpenAI 상위 계층의 연산 변동; 4K Detail 티어에서 더 자주 발생함	2K Recommended로 낮추고 재시도하십시오; 4K가 필수라면 공식 프록시 `gpt-image-2` + `image2Enterprise` 그룹으로 전환하십시오
`5xx` (기타)	일시적인 게이트웨이/백엔드 오류	1–2회 재시도하십시오
타임아웃	Codex 피크 + 4K 롱테일	클라이언트 타임아웃을 ≥ 300s로 설정하십시오 (보수적 기준)

클라이언트 권장 사항:

요청 타임아웃은 300초부터 설정하십시오 (보수적 기준; 일반적으로는 90–150s이지만 4K Detail + 피크 꼬리 구간에서는 더 길어집니다)
5xx 및 타임아웃에는 지수 백오프를 사용하십시오 (2–3회 재시도 권장)
디버깅을 위해 request-id 응답 헤더를 기록하십시오

자주 묻는 질문

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는 Codex 역방향 채널을 사용합니다 — 일반적으로 90~150초이며, 공식 gpt-image-2(100~~120초)와 비슷하고 ChatGPT-web-line gpt-image-2-all(30~~60초)보다 느립니다. 지연 시간에 민감한 워크로드에는 gpt-image-2-all를 선호하십시오. 고정 사이즈나 4K가 필요할 때만 vip로 전환하십시오.

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

예 — 30개 사이즈 세트를 그대로 사용하십시오. 목록에 없는 사이즈는 상위 invalid_request_error를 유발할 수 있습니다. 결과물에 가장 가까운 등급을 선택하십시오.

왜 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에서는 통과합니다. Codex 역방향 채널은 특히 피크 시간대에 4K 같은 큰 출력에 더 민감합니다.완화책(비용 대비 효과 순):

2K Recommended를 우선 사용(예: 2048x1360 / 2048x2048) — 성공률이 크게 높고, 비용은 동일하게 $0.03/image입니다
img2img / 다중 이미지 융합에서는 입력 이미지 수를 줄이십시오 — Codex 역방향 채널은 입력 부하가 크면 더 취약해져 4K 실패율이 더 올라가며, 각 입력 이미지를 1.5MB 미만으로 미리 압축하는 것도 도움이 됩니다
4K를 보장하려면 공식 프록시 gpt-image-2 + image2Enterprise 그룹으로 전환하십시오. 공식 프록시 4K는 더 비싸지만(약 $0.3+/image), 훨씬 더 안정적입니다 — 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 파라미터로 결정되며, 입력 크기와는 무관합니다. 입력을 줄이면 속도만 빨라집니다.4K / 8K를 prompt에 넣는다고 실제로 4K 출력이 나오지는 않습니다. prompt에 8K ultra HD라고 적어도 size를 1024x1024로 설정하면 여전히 1K 품질 이미지를 받습니다. 4K가 필요하면 size 필드에 설정하십시오 — 30개 사이즈 세트에서는 1K / 2K / 4K 모두 동일하게 고정 $0.03/image입니다.📖 출처: /en/live/2026-05/gpt-image-2-vip-unknown-error

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

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

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

아닙니다. 이 모델은 호출당 1장의 이미지만 반환합니다 — 여러 이미지가 필요하면 대신 반복 / 동시 호출을 사용하십시오.⚠️ 중요: 요청에 n=3를 전달하면 과금은 0.03 × 3 = $0.09이지만, 실제로는 1장만 반환됩니다. 낭비되는 과금을 피하려면 n 필드를 제거하십시오.

콘텐츠가 거부되거나 모델이 'I can't do that'라고 답하면 과금됩니까?

이 경로는 동기식 채팅 스타일 응답을 사용하는 역공학 채널입니다. 결과는 서로 다른 과금 규칙을 가진 두 가지 경우로 나뉩니다.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과 텍스트 “soft refusal” → 과금됨모델이 대화 중에 소프트 거부를 하면(예: “I can’t do that”, “Sorry, this request involves…”) 프로토콜 수준에서는 일반적인 chat completion처럼 보이므로 과금됩니다. 역방향 채널은 프로토콜 계층에서 “거부 텍스트”와 “이미지 출력”을 안정적으로 구분할 수 없습니다.왜 soft refusal을 그냥 면제할 수 없는가모든 soft refusal을 자동 면제하면 플랫폼이 실패한 상위 호출 비용을 전부 떠안게 됩니다. 더 중요한 점은, 상위 콘텐츠 안전 정책을 자주 건드리면 공급업체 계정이 차단될 위험도 높아집니다 — 이는 실제 공급 측 비용이며 완전히 없앨 수는 없습니다.연동자 권장사항

✅ 소비자용 제품의 월별 보전: 소비자 대상 제품은 사용자 입력을 완전히 차단할 수 없다는 점을 이해합니다. 월 지출이 충분히 크다면($1000+/month), 로그를 월 단위로 묶어 제출할 수 있으며(짧은 지연 시간 호출은 보통 soft refusal입니다) 지원팀에 일회성 수동 크레딧을 요청할 수 있습니다 — 호출별 이의 제기를 할 필요는 없습니다.

📖 관련: 500 오류는 보통 콘텐츠 정책 적중입니다(과금되지 않음)

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

먼저 감지한 뒤 처리하십시오. 2026년 7월 기준으로 확인된 바에 따르면, 반환된 b64_json는 data: prefix가 없는 원시 base64입니다. 파일로 쓰려면 디코딩하고, 렌더링 전에 직접 prefix를 붙이십시오. 이전 버전에는 prefix가 포함되어 있었습니다. 코드에 startsWith('data:') 검사를 추가하십시오: prefix가 있으면 값을 그대로 img src로 사용하고, 없으면 먼저 디코딩하거나 prefix를 붙이십시오. 이렇게 하면 prefix를 두 번 붙이거나, prefix가 붙은 문자열을 디코딩해 깨진 이미지를 만드는 일을 피할 수 있습니다.

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

이미지당 권장 ≤ 10MB이며, 형식은 png / jpg / webp입니다. 너무 큰 이미지는 게이트웨이 한도에 걸릴 수 있습니다. 다중 이미지 융합의 각 이미지는 이 제한을 충족해야 합니다.

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

url-mode 응답의 url 필드는 약 1일(24시간) 후 만료되는 R2 CDN 링크입니다 — 그 이후의 요청은 404가 됩니다.강력히 권장합니다: 생성 직후 이미지를 자신의 object storage(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-vip", size="2048x1360", prompt=...)은 그대로 작동합니다.

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

예, 엔드포인트는 여전히 작동하지만 더 이상 권장되지 않습니다 — 대신 /v1/images/generations와 /v1/images/edits를 사용하십시오(더 안정적이며, 공식 릴레이 gpt-image-2와도 같은 코드가 작동합니다).채팅 기반 스타일은 두 가지 경우에만 의미가 있습니다. 다회차 반복 편집 또는 온라인 이미지 URL 직접 전달입니다. 이미지 의도가 모호하면 모델이 이미지 대신 일반 텍스트를 반환할 수 있습니다(이를 강화하려면 prompt 앞에 “이미지를 생성하십시오:” 같은 고정 prefix를 붙이십시오).전체 파라미터는 채팅 기반 API 참조를 보십시오.

언제 공식 gpt-image-2로 전환해야 합니까?

quality 조절값(low/medium/high), 마스크 기반 로컬 재페인팅, 또는 엄격한 OpenAI API 필드 일치성이 필요할 때는 gpt-image-2를 사용하십시오. 공식 vs 역방향 비교도 보십시오.

기초

기본 API

이미지 API (공식)

동영상 API (공식)

멀티모달 이해 API

텍스트 API

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

개요

Text-to-Image API

Image Editing API

`gpt-image-2-all`과의 주요 차이점

핵심 기능

출력 크기 고정

4K 고해상도

모든 크기에 동일한 요금

-all과 동일한 호출 형식

고품질 텍스트 렌더링

중국어 Prompt 친화적

자연어 편집

표준 엔드포인트 지원

가격

그룹 설정

결정적인 URL 출력을 원하면 → `image2_OSS` 그룹으로 전환하십시오

기술 사양

엔드포인트

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

1K Fast — 초안 및 저비용 반복 작업

2K Recommended — 기본 티어(대부분의 프로덕션 출력)

4K Detail — 대형 산출물

권장 사항

오류 코드 및 재시도

자주 묻는 질문

관련 문서

​개요

Text-to-Image API

Image Editing API

​gpt-image-2-all과의 주요 차이점

​핵심 기능

출력 크기 고정

4K 고해상도

모든 크기에 동일한 요금

-all과 동일한 호출 형식

고품질 텍스트 렌더링

중국어 Prompt 친화적

자연어 편집

표준 엔드포인트 지원

​가격

​그룹 설정

​결정적인 URL 출력을 원하면 → image2_OSS 그룹으로 전환하십시오

​기술 사양

​엔드포인트

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

​1K Fast — 초안 및 저비용 반복 작업

​2K Recommended — 기본 티어(대부분의 프로덕션 출력)

​4K Detail — 대형 산출물

​권장 사항

​오류 코드 및 재시도

​자주 묻는 질문

​관련 문서

개요

`gpt-image-2-all`과의 주요 차이점

핵심 기능

가격

그룹 설정

결정적인 URL 출력을 원하면 → `image2_OSS` 그룹으로 전환하십시오

기술 사양

엔드포인트

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

1K Fast — 초안 및 저비용 반복 작업

2K Recommended — 기본 티어(대부분의 프로덕션 출력)

4K Detail — 대형 산출물

권장 사항

오류 코드 및 재시도

자주 묻는 질문

관련 문서