Skip to Content
모델 사용법GPT Image개요

GPT Image 시리즈

OpenAI의 이미지 생성 모델인 gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2입니다. 세 모델 모두 OpenAI 호환 API로 호출합니다.

이 시리즈 문서의 내용은 모두 실제 API를 대상으로 측정했으며, 모든 코드 예시는 그대로 실행하여 확인했습니다. 최종 확인일: 2026-09-30.

무엇을 하시겠습니까?

텍스트로 이미지 생성 텍스트 프롬프트로 이미지를 생성합니다.이미지 편집 및 합성 이미지를 한 장 이상 업로드하고 프롬프트로 수정하거나 합성합니다.부분 수정(인페인팅) 마스크로 영역을 지정하고 그 영역만 다시 그립니다.내 도구에서 이미지 생성 코드가 필요 없습니다. Cherry Studio나 LobeHub에서 몇 가지 설정만 입력하거나, Claude Code 또는 Codex에 프롬프트 하나를 복사해 보내면 됩니다.

이 엔드포인트들이 공통으로 사용하는 요청 구조와 응답 필드는 Images API를 참고하십시오.

어떤 모델을 사용할지

gpt-image-2.5-flare텍스트로 이미지 생성
  • 일상적인 생성과 일괄 생성에 적합하며 빠릅니다
  • 품질 6단계: low ~ max
Azure · OpenAI
gpt-image-2.5-sunburst편집
  • 이미지 편집과 합성에 적합하며 원본 충실도가 더 높습니다
  • 품질 6단계: low ~ max
Azure · OpenAI
gpt-image-2이전 세대
  • 기존 프로젝트에서 계속 사용해도 됩니다
  • 품질 4단계, xhigh와 max 없음
Azure · OpenAI

gpt-image-2에서 2.5로 전환할 때는 품질 등급을 다시 선택하십시오. 아래 품질과 가격을 참고하십시오. 두 공급자 모두 텍스트로 이미지 생성과 편집을 제공하며, 게이트웨이가 요청을 자동으로 라우팅합니다.

모델 ID(그대로 복사하십시오)
텍스트로 이미지 생성openai/gpt-image-2.5-flare일상적인 생성과 일괄 생성, 빠름
편집openai/gpt-image-2.5-sunburst이미지 편집과 합성, 원본 충실도가 더 높음
이전 세대openai/gpt-image-2xhigh와 max 등급 없음

품질(quality)과 가격

가격에 가장 큰 영향을 주는 것은 quality입니다. 등급이 높을수록 비용이 늘고 시간도 오래 걸립니다.

OpenAI 공식 참고 가격(이미지 1장당, 출력 이미지만 해당하며 프롬프트와 참고 이미지는 포함하지 않음):

등급gpt-image-2 · 1024×1024gpt-image-2 · 1024×1536 또는 1536×1024
low$0.006$0.005
medium$0.053$0.041
high$0.211$0.165

OpenAI는 두 2.5 모델에 대해 이미지 1장당 가격표를 공개하지 않았으며, 대신 단가를 제시합니다. 출력 이미지 토큰 100만 개당 $30, 참고 이미지 입력 토큰 100만 개당 $8, 텍스트 입력 토큰 100만 개당 $5입니다. OpenAI의 계산 예시에 따르면 1024×1024 이미지를 low로 생성하면 출력 토큰이 196개이며 약 $0.00588입니다. 다른 등급과 크기는 공식 계산기 로 추정하십시오.

위 수치는 OpenAI 공식 수치이며, 실제 청구액은 각 응답의 usage를 따릅니다. OfoxAI의 실시간 가격(할인 포함)은 모델 페이지 에서 확인하십시오.

모델별 지원 등급:

등급2.5(flare, sunburst)gpt-image-2
low / medium / high지원지원
xhigh / max지원지원하지 않으며 400을 반환합니다
auto 또는 생략모델이 결정합니다. medium과 같지 않으므로 명시적으로 지정하십시오동일

standard와 hd(DALL·E 시절의 값)는 지원하지 않으며 400을 반환합니다.

지연 시간과 타임아웃(timeout)

API는 동기 방식이며, 이미지 생성이 끝난 뒤에야 응답이 반환됩니다. 클라이언트가 먼저 연결을 끊으면 이미지는 받을 수 없지만 요청 비용은 그대로 청구됩니다.

요청 전송생성 중 — 몇 분이 걸릴 수 있음이미지 반환
60 / 120초 흔한 기본값: 생성 도중 연결이 끊겨 이미지를 잃고 비용은 청구됨
600초 권장: 이미지가 반환될 때까지 기다림

클라이언트 타임아웃을 600초로 설정하십시오. 지연 시간은 모델, 품질, 크기에 따라 달라집니다. 고품질, 큰 크기, 편집 요청은 몇 분이 걸릴 수 있으므로 흔히 쓰이는 60초나 120초의 기본 타임아웃으로는 부족합니다.

크기(size)

size에는 사용자 지정 너비x높이를 지정할 수 있으며, 아래 네 가지 규칙을 모두 만족해야 합니다. 하나라도 어기면 400을 반환합니다.

16의 배수
  • 너비와 높이 모두 16으로 나누어떨어짐
✗ 1000x1000
긴 변 ≤ 3840
  • 어느 변도 3840을 넘지 않음
✗ 4096x4096
종횡비 ≤ 3:1
  • 1:3에서 3:1 사이
✗ 3200x1024
픽셀 수 ≥ 655,360
  • 총 픽셀 수 655,360 이상
✗ 768x768 → ✓ 1024x768

생략하거나 auto로 지정하면 모델이 크기를 정합니다. 1024×1024라는 보장이 없으며 참고 이미지와 같다는 보장도 없습니다. 실측에서는 텍스트로 이미지 생성과 편집 모두 1254×1254가 반환되었습니다. 고정된 크기가 필요하면 명시적으로 지정하십시오.

문서에 명시된 최대 크기는 3840×2160이며, 2560×1440을 넘는 크기는 실험적 기능으로 표시되어 있습니다.

기술 사양

항목사양
응답동기 방식. 이미지는 data[0].b64_json에 순수 base64로 담깁니다
출력 크기네 가지 제약 내에서 너비와 높이를 자유롭게 지정, 최대 3840×2160
품질 등급품질과 가격 참고
출력 형식png(기본값), jpeg, webp
요청당 이미지 수1–10, 기본값 1
참고 이미지장당 ≤ 15 MB, 요청당 ≤ 50 MB. 업로드 제한 참고
타임아웃클라이언트 타임아웃을 600초로 설정. 지연 시간과 타임아웃 참고

공급자 지정

일반적으로는 지정할 필요가 없습니다. 콘텐츠 심사와 관련한 요구 사항이 있을 때 지정하십시오. 공급자마다 심사 기준이 다르며, 예를 들어 gpt-image-2는 Azure에서 더 엄격하고 OpenAI에서는 비교적 완화되어 있습니다.

지정하지 않음(권장)
요청→OfoxAI 게이트웨이→AzureOpenAI

게이트웨이가 Azure와 OpenAI 중 사용 가능한 공급자를 자동으로 선택합니다.

공급자 지정
요청openai→OfoxAI 게이트웨이→AzureOpenAI

요청은 해당 공급자로만 전달되며, 그 공급자를 사용할 수 없어도 다른 공급자로 전환되지 않습니다.

공급자 지정 방법
헤더X-OfoxAI-Provider-Type: openai텍스트로 이미지 생성과 편집 모두에서 유효합니다. 값: azure_foundry, openai
요청 본문"extra_body": { "provider": { "type": "openai" } }텍스트로 이미지 생성에서만 유효합니다. 편집은 multipart 업로드이므로 헤더만 받습니다

자세한 내용은 공급자 라우팅을 참고하십시오.

자주 발생하는 오류

오류원인해결 방법
moderation_blocked (Your request was rejected by the safety system)프롬프트나 참고 이미지가 상위 안전 시스템에 의해 차단되었습니다프롬프트나 참고 이미지를 바꿔 다시 시도하십시오. 그대로 재시도하면 결과가 같습니다. 심사와 관련한 요구 사항이 있다면 공급자 지정을 검토하십시오
타임아웃, 504, 524, Request timed out생성이 끝나기 전에 클라이언트나 중간 프록시(Nginx, Vercel, Cloudflare 등)가 타임아웃되었습니다클라이언트와 프록시의 타임아웃을 600초로 설정하십시오. 지연 시간과 타임아웃 참고
404 model_not_found모델 ID의 철자나 대소문자가 잘못되었습니다. 예: GPT-Image-2이 페이지에서 모델 ID를 복사하십시오. 모두 소문자입니다
provider_type_unavailable직접 지정한 공급자가 이 모델을 제공하지 않습니다공급자 파라미터를 제거하고 게이트웨이가 라우팅하도록 하십시오
unknown provider type헤더의 공급자 이름 철자가 잘못되었습니다철자를 확인하십시오
Invalid size크기가 네 가지 규칙 중 하나를 어겼습니다크기 참고
does not support quality 'xhigh'gpt-image-2에 xhigh 또는 max를 보냈습니다high를 사용하거나 2.5로 전환하십시오
Invalid value: 'standard'quality를 standard 또는 hd로 지정했습니다low부터 max까지의 값을 사용하십시오
Invalid image file or mode참고 이미지나 마스크의 형식이 올바르지 않습니다표준 PNG 또는 JPEG로 다시 내보내십시오
Invalid file 'image[0]': unsupported mimetype업로드한 파일이 이미지가 아닙니다PNG, JPEG 또는 WebP 이미지를 업로드하십시오
does not support the 'input_fidelity' parameter편집 요청에 input_fidelity가 포함되었습니다제거하십시오. 2.5 모델과 gpt-image-2는 참고 이미지를 항상 높은 충실도로 처리합니다
Transparent background is not supported for JPEG output formatjpeg 출력에 투명 배경을 요청했습니다png 또는 webp를 사용하십시오
Unknown parameter이 시리즈가 지원하지 않는 파라미터입니다제거하십시오
429 rate_limit_exceeded분당 100회를 초과했습니다(팀 단위)잠시 후 다시 시도하십시오. 키를 늘려도 한도는 올라가지 않습니다

전체 오류 목록은 오류 처리를 참고하십시오.

오류 메시지 원문

실측한 전체 메시지입니다. 검색하거나 대조할 때 활용하십시오.

Invalid size '1000x1000'. Width and height must both be divisible by 16.
Invalid size '4096x4096'. The longest edge must be less than or equal to 3840.
Invalid size '3200x1024'. The maximum supported aspect ratio is 3:1.
Invalid size '768x768'. Requested resolution is below the current minimum pixel budget.
The model 'gpt-image-2' does not support quality 'xhigh'.
Invalid value: 'standard'. Supported values are: 'low', 'medium', 'high', and 'auto'.
Invalid 'n': integer above maximum value. Expected a value <= 10, but got 11 instead.
Unknown parameter: 'style'.
The model 'gpt-image-2.5-sunburst' does not support the 'input_fidelity' parameter.
Transparent background is not supported for JPEG output format
Invalid file 'image[0]': unsupported mimetype ('text/plain; charset=utf-8'). Supported file formats are 'image/jpeg', 'image/png', and 'image/webp'.
unknown provider type in X-OfoxAI-Provider-Type header
Model 'GPT-Image-2' not found
Invalid image file or mode for image 1

Invalid value: 'standard'에 나열된 지원 값 목록은 완전하지 않습니다. 2.5 모델은 xhigh와 max도 받습니다. 이 페이지의 등급 표를 기준으로 하십시오.

효과가 없는 파라미터

다음 파라미터는 오류를 일으키지는 않지만 이 시리즈에서는 아무 효과가 없습니다. 요청은 성공하며 평소대로 청구됩니다.

파라미터이유
mask(텍스트로 이미지 생성 시)편집 엔드포인트에서만 동작합니다
response_formatDALL·E 시절의 파라미터입니다. 이 시리즈는 항상 base64(b64_json)를 반환합니다. OpenAI를 직접 호출하면 Unknown parameter: 'response_format'이 반환되지만, OfoxAI를 통하면 무시됩니다
input_fidelity(텍스트로 이미지 생성 시)gpt-image-1.5용 파라미터입니다. 참고: 편집 엔드포인트로 보내면 400을 반환합니다
input_imagesQwen 이미지 시리즈용 파라미터입니다

오류가 나지 않았다고 해서 적용된 것은 아닙니다. 예를 들어 style은 바로 거부되지만, 위 파라미터들은 조용히 무시됩니다.

공식 문서

OpenAI 문서는 OpenAI를 직접 호출할 때의 동작을 설명합니다. OfoxAI를 통해 호출할 때는 이 시리즈 문서의 실측 결과가 우선합니다. 예를 들어 가격은 응답의 usage와 모델 페이지를 따릅니다.

자주 묻는 질문

GPT Image 2.5는 어떤 크기든 받습니까?

네 가지 규칙을 만족하면 사용자 지정 크기를 받습니다. 너비와 높이가 16으로 나누어떨어질 것, 긴 변이 3840 이하일 것, 종횡비가 1:3에서 3:1 사이일 것, 총 픽셀 수가 655,360 이상일 것입니다. 하나라도 어기면 400을 반환합니다. 예를 들어 768x768은 픽셀 수가 부족하여 거부되지만 1024x768은 사용할 수 있습니다.

size를 생략하면 어떤 크기가 나옵니까?

모델이 정합니다. 1024x1024라는 보장이 없으며 참고 이미지와 같다는 보장도 없습니다. 실측에서는 텍스트로 이미지 생성과 편집 모두 1254x1254가 반환되었습니다. 고정된 크기가 필요하면 명시적으로 지정하십시오.

gpt-image-2는 xhigh와 max 품질을 지원합니까?

지원하지 않으며, 둘 다 400을 반환합니다. xhigh와 max는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst에서만 지원됩니다. gpt-image-2는 low, medium, high, auto를 받습니다.

GPT Image 2.5의 quality를 hd나 standard로 지정할 수 있습니까?

지정할 수 없으며 400을 반환합니다. 유효한 값은 low, medium, high, xhigh, max, auto입니다. 생략하면 모델이 등급을 스스로 고르므로(실측에서는 low), 품질을 일정하게 유지하려면 명시적으로 지정하십시오.

gpt-image-2 / GPT Image 2.5 API의 타임아웃은 얼마로 설정해야 합니까?

클라이언트 타임아웃을 600초로 설정하십시오. 지연 시간은 모델, 품질, 크기에 따라 달라지며 고품질, 큰 크기, 편집 요청은 몇 분이 걸릴 수 있습니다.

GPT Image 오류 moderation_blocked(Your request was rejected by the safety system)는 어떻게 해결합니까?

프롬프트나 참고 이미지가 상위 안전 시스템에 의해 차단된 것으로, 주로 실존 인물, 저작권이 있는 캐릭터, 민감한 콘텐츠가 원인입니다. 프롬프트나 참고 이미지를 바꿔 다시 시도하십시오. 그대로 재시도하면 결과가 같습니다. 응답의 error.moderation_details에서 입력 단계와 출력 단계 중 어디에서 차단되었는지 확인할 수 있습니다. 공급자마다 심사 기준이 다르므로, 심사와 관련한 요구 사항이 있다면 공급자 지정을 검토하십시오.

GPT Image 오류 Unknown parameter: response_format은 어떻게 해결합니까?

response_format은 DALL·E 시절의 파라미터입니다. GPT Image는 base64(data[0].b64_json)만 반환하며 이미지 URL은 제공하지 않습니다. response_format을 제거하고 output_format으로 png, jpeg, webp 중에서 선택하십시오. OfoxAI를 통하면 이 파라미터는 무시되며 오류가 발생하지 않습니다.

gpt-image를 호출할 때 "Your organization must be verified"가 나오면 어떻게 합니까?

이는 OpenAI를 직접 이용할 때 요구되는 조직 인증입니다. OfoxAI를 통하면 조직 인증을 직접 받을 필요가 없으며, OfoxAI API 키로 gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2를 호출할 수 있습니다.

GPT Image 요청이 타임아웃되거나 504, 524를 반환하면 어떻게 합니까?

API는 동기 방식이며, 고품질, 큰 크기, 편집 요청은 몇 분이 걸릴 수 있습니다. 클라이언트 타임아웃을 600초로 설정하고, Nginx, Vercel, Cloudflare 등 중간 프록시의 타임아웃도 확인하십시오. 이들의 기본값은 60초에서 100초에 불과한 경우가 많습니다.

GPT Image 오류 does not support the input_fidelity parameter는 어떻게 해결합니까?

GPT Image 2.5와 gpt-image-2는 참고 이미지를 항상 높은 충실도로 처리하므로 편집 엔드포인트가 input_fidelity를 받지 않습니다. 제거하십시오. 이 파라미터는 gpt-image-1.5에만 해당합니다.

GPT Image 오류 Invalid size는 어떻게 해결합니까?

크기가 네 가지 규칙 중 하나를 어긴 것이며, 메시지에 어떤 규칙인지 나와 있습니다. divisible by 16은 너비나 높이가 16의 배수가 아니라는 뜻이고, longest edge는 긴 변이 3840을 넘었다는 뜻이며, aspect ratio는 종횡비가 3:1을 넘었다는 뜻이고, minimum pixel budget은 픽셀 수가 655,360 미만(예: 768x768)이라는 뜻입니다. 1024x768, 1024x1024, 1536x1024처럼 네 가지를 모두 만족하는 크기를 사용하십시오.

GPT Image 이미지 1장의 비용은 얼마입니까?

토큰 단위로 청구되며 품질 등급의 영향이 가장 큽니다. gpt-image-2로 1024x1024 이미지를 생성할 때의 OpenAI 공식 참고 가격은 low 약 $0.006, medium $0.053, high $0.211입니다. 두 2.5 모델은 출력 이미지 토큰 100만 개당 $30이므로 1024x1024를 low로 생성하면 약 $0.006입니다. 실제 청구액은 응답의 usage를 따르며, OfoxAI의 실시간 가격은 모델 페이지에서 확인하십시오.

GPT Image 2.5로 편집할 때 공급자를 지정해야 합니까?

지정할 필요가 없습니다. Azure와 OpenAI 모두 2.5 편집 엔드포인트를 제공하며, 게이트웨이가 요청을 자동으로 라우팅합니다.

Last updated on
텍스트로 이미지 생성