GPT-Image
OpenAI의 이미지 모델 네 가지, 화면 비율 기본값 규칙, 그리고 GPT-Image-2 Pro만 quality를 반영하는 이유.
GPT-Image는 ListenHub에서 쓰는 OpenAI의 이미지 모델 시리즈이고, gpt-image-2는 전체 모델 목록의
기본 모델입니다 — model을 생략했을 때 선택되는 모델입니다. 네 모델 모두 공유 이미지 엔드포인트에서
동작합니다. 엔드포인트, 요청 스키마, 비동기 흐름, 에러 코드는
이미지 생성 개요를 참고하세요. 이 페이지는
GPT-Image 전용 내용만 다룹니다.
모델
| 모델 | 표시 이름 | 적합한 용도 |
|---|---|---|
gpt-image-2 (기본값) | GPT-Image-2 | 크기별 고정 가격으로 프롬프트를 충실히 따름 |
gpt-image-2.5-flare | GPT-Image-2.5 Flare | 가격과 제한은 같고 다른 비주얼 스타일 |
gpt-image-2.5-sunburst | GPT-Image-2.5 Sunburst | 가격과 제한이 같은 세 번째 스타일 |
gpt-image-2-official | GPT-Image-2 Pro | quality를 반영하는 유일한 모델; token 단위 과금 |
네 모델 모두 provider: "openai"를 사용합니다. Flare와 Sunburst는 gpt-image-2와 요금도 제한도
완전히 같습니다 — 셋 중 무엇을 고르든 달라지는 것은 출력의 느낌이지 비용이나 제약이 아닙니다.
제한
| 제한 항목 | gpt-image-2, …-2.5-flare, …-2.5-sunburst | gpt-image-2-official |
|---|---|---|
| 이미지 크기 | 1K, 2K, 4K | 1K, 2K, 4K |
| 화면 비율 | 표준 10종 비율 | 표준 10종 비율 |
| 기본 화면 비율 | schema 기본값 1:1(아래 참고) | schema 기본값 1:1(아래 참고) |
| 참조 이미지 | 최대 4장 | 최대 4장 |
quality | 무시됨 | low, medium, high |
| 구독 게이트 | 없음 | 4K 또는 quality: high는 구독 필요 |
GPT-Image는 검증기가 비율을 대신 바꿔 넣는 일이 없는 유일한 시리즈입니다 — 하지만 요청 스키마는
바꿔 넣습니다. imageConfig.aspectRatio의 기본값은 1:1이므로, 모델 자신의 선택에 도달하는
방법은 imageConfig 객체 전체를 생략하는 것뿐입니다. aspectRatio 없이 imageConfig를 보내면
정사각형 이미지가 나옵니다. 극단 비율(1:4, 4:1, 1:8, 8:1)을 보내면 code: 26019와 함께
400이 반환되고, 메시지에 지원 비율 목록이 담깁니다.
참조 이미지는 요청당 4장으로 제한됩니다. 초과하면 400이 반환되며 메시지는
GPT-Image-2 supports at most 4 reference images입니다.
quality 파라미터
imageConfig.quality는 low, medium, high를 받지만, 요청한 품질로 렌더링하는 모델은
gpt-image-2-official 뿐입니다.
gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst에 quality를 보내는 것은 오류가
아닙니다 — 값이 조용히 버려집니다. estimate-credits는 이를 warnings 배열에 경고
quality_ignored_for_gpt_image_2_lite로 노출합니다. 제품에 품질 선택기가 있다면 이 배열을 읽어서,
선택한 모델이 무시하는 컨트롤을 제공하는 일이 없도록 하세요.
요금과 구독 게이트
세 lite 모델은 이미지 크기별 고정 크레딧 비용으로 과금되며(pricing.mode는 fixed,
pricingVersion은 gpt-image-2-lite-fixed-2026-06-15), requiresSubscription을 설정하는 일이
없습니다.
gpt-image-2-official은 예상 token 수를 기준으로 과금되므로(pricing.mode는 token-estimate),
비용이 프롬프트 길이, 출력 크기, 요청한 품질, 참조 이미지 개수에 따라 달라집니다 — API에서는 참조
이미지 한 장을 고정 단가로 계산하는데, OpenAPI 경로가 각 이미지의 크기가 아니라 개수를 보내기
때문입니다. 또한 전체 이미지 모델 목록에서 requiresSubscription: true를 설정하는 유일한 구성입니다
— 4K일 때, 또는 quality: high일 때입니다. 구독이 없는 계정에 두 옵션 중 하나라도 제공하기 전에
예상 결과의 해당 필드를 확인하세요.
gpt-image-2는 1K와 2K에 무료 할당량 리소스가 있고, Flare와 Sunburst는 하나를
공유합니다(gpt-image-2.5). gpt-image-2-official은 어떤 크기에서도 무료 할당량이 없습니다.
예시
curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/estimate-credits" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2-official",
"prompt": "A product hero shot of a matte black espresso machine on concrete",
"imageConfig": { "imageSize": "4K", "aspectRatio": "16:9", "quality": "high" }
}'응답의 requiresSubscription은 이 설정에 활성 구독이 필요한지를, credits는 비용이 얼마나 되는지를
알려 줍니다. 전체 응답 구조는
이미지 생성 개요를 참고하세요.