먼저 결론부터 말씀드릴게요. APIYI에서 이미지를 대량 생성할 때 일반 작업은 기본적으로 gpt-image-2.5-all을 쓰고 Default 그룹을 이용하면 돼요. 호출 횟수 기준 토큰과 사용량 기준 토큰 어느 쪽으로도 호출할 수 있고, 표시 가격은 장당 0.025달러예요. 특정 크기나 4K로 고정해야 할 때는 모델명을 gpt-image-2.5-vip 같은 -vip 모델로 바꾸면 되고, 표시 가격은 장당 0.03달러예요. 다만 -all 전용 페이지에는 -vip의 4K가 안정성 편차가 있어 4K 첫 선택으로는 권장하지 않는다고 적혀 있어요. 공식 quality 등급, 마스크를 이용한 부분 재생성, 또는 허용되는 임의 크기가 필요하면 공식 중계(官转)를 이용하세요. 새 프로젝트라면 gpt-image-2.6-flare(속도 우선)와 gpt-image-2.6-sunburst(편집 및 정밀도 우선)를 우선 살펴보세요.
폴백은 두 가지 경우로 나뉘어요. 공식 중계가 Default 그룹에서 계속 429 오류를 반환하거나 포화 상태라면 토큰 그룹을 image2Enterprise로 바꾸세요. 모델명은 그대로 두면 돼요. 공식 리버스(官逆)가 ChatGPT 웹 버전이나 Adobe 원본 서비스 장애를 만나면 같은 리버스 경로에서 백오프(재시도 대기)를 반복하지 말고, 모델명을 공식 중계 모델로 바꾼 뒤 토큰이 ‘사용량 우선’인지 확인하세요. 또 두 가지 오류는 그대로 재시도하면 안 돼요. 콘텐츠 안전 거부와 파라미터 오류예요. n 파라미터도 주의해야 해요. -all에서는 n배로 과금되지만 실제로는 이미지 1장만 반환해요.
GPT 이미지 채널의 네 가지 이름, 각각 무엇일까요?
같은 GPT 이미지 모델이 목록에서 여러 접미사로 나타나는데, 각각 업스트림 소스와 과금 방식을 뜻해요. 그중 ‘기업 그룹’은 모델이 아니라 토큰에 붙는 라우팅 옵션이에요. 아래에서 문서에 쓰인 용어를 하나씩 짚어 볼게요.
- 官转(공식 직접 연결): OpenAI Images API에 공식적으로 직결되며, 문서에는 요청과 응답이 OpenAI 공식과 동일하다고 나와 있어요. 전체 가격표에 있는 官转 이미지 모델은
gpt-image-2.6-flare,gpt-image-2.6-sunburst,gpt-image-2.5-flare,gpt-image-2.5-sunburst, 이 둘의 날짜 스냅샷인gpt-image-2.5-flare-2026-09-08과gpt-image-2.5-sunburst-2026-09-08, 그리고 이전 세대인gpt-image-2예요. 문서에서는 텍스트-이미지 변환에는 flare를, 편집과 다중 이미지 융합에는 sunburst를 우선 사용하라고 권장해요. 프로덕션 환경에서는 날짜 스냅샷을 고정해 별칭이 가리키는 대상이 바뀌는 일을 피할 수 있어요. - 官逆 -all(역방향 -all): ChatGPT 웹 버전을 역으로 활용하는 경로예요.
gpt-image-2-all과gpt-image-2.5-all은 가격이 같고 동작도 같아서 서로 바꿔 써도 돼요. ChatGPT 웹 버전이 전체적으로 Images 2.5로 업그레이드되었기 때문에gpt-image-2-all로 생성해도 2.5 이미지가 나와요. 문서에서는 새 프로젝트라면gpt-image-2.5-all을 바로 쓰라고 권장해요. - 官逆 -vip(역방향 -vip): Adobe의 역방향 경로(Firefly)이고, 모델명은
gpt-image-2-vip,gpt-image-2.5-flare-vip,gpt-image-2.5-sunburst-vip예요. 별칭gpt-image-2.5-vip는gpt-image-2.5-sunburst-vip를 가리켜요. - 기업 그룹
image2Enterprise: OpenAI 업스트림에서 官转을 위한 기업용 폴백 그룹이에요. FAQ에서는 이것이 Google Vertex가 아니고, 이미지 생성 시간을 줄여 주는 가속 라인도 아니라고 분명히 설명해요. 기본 그룹이 혼잡할 때 또 하나의 리소스 풀을 제공하는 역할이지만, 업스트림이 항상 사용 가능하다고 보장하지는 않아요.
또 하나, 폴백으로 오해하기 쉬운 그룹이 있는데 바로 image2_OSS예요. 이 그룹은 1배, 즉 가격 인상이 없는 그룹이고 용도는 하나뿐이에요. 반환값이 base64로 다운그레이드되지 않고 URL로 돌아오도록 보장하는 거죠. 안정성을 높여 주는 건 아니고, -all과 -vip에 적용돼요.
2.6은 현재 官转 버전만 있어요. 2026-11-10 기준 전체 가격표와 가격 책정 API 어디에도 gpt-image-2.6-all, gpt-image-2.6-vip 또는 비슷한 이름은 없어요. 모델과 가격은 플랫폼의 모델 목록을 기준으로 봐 주세요.
시나리오별 기본 이미지 채널 선택: 가격과 기능 비교표
채널을 고를 때는 먼저 세 가지 질문부터 확인하세요. 공식 화질 등급이 필요한가, 사이즈 요구가 얼마나 엄격한가, 비용을 장당 상한으로 묶어야 하는가. 아래 순서대로 판단하면 됩니다.
- 대량 이미지 생성, 장당 비용 상한, 긴 변이 512에서 1536 사이인 사이즈:
gpt-image-2.5-all을 사용하세요. 검수 기준: 반환된 이미지의 실제 가로·세로 길이가 예상과 일치하고, 콘솔에서 매번 차감되는 금액이 단가 × 호출 횟수와 같아야 해요. - 30개 등급 중 고정 사이즈가 필요하거나 2K, 4K가 필요할 때: -vip 모델로 바꾸고
size를 명시적으로 전달하세요. 검수 기준: 요청 파라미터만 보지 말고 반환된 이미지의 실제 가로·세로 길이를 기준으로 삼아야 해요. - 공식
quality,mask부분 재그리기, 투명 배경, 임의의 합법적 사이즈가 필요하거나 OpenAI 필드와 정렬해야 할 때: 공식 중계 경로를 이용하세요. 신규 프로젝트는 2.6을, 동작을 고정해야 할 때는 날짜가 붙은 2.5 스냅샷을 쓰세요. 검수 기준: 요청 필드가 대상 모델의 공식 파라미터 표와 일치하고 400이 발생하지 않아야 해요.
이미지 채널 가격 비교표
아래 표의 과금 방식과 표시 가격은 전체 가격표(2026-11-09 업데이트)에서 가져온 것이며, 모두 할인 전 표시 가격이에요. 충전 시 10%~20% 추가 증정이 적용되면 실제 차감 금액은 더 낮아지고, 최종 금액은 콘솔을 기준으로 해요. 전체 모델과 가격은 docs.apiyi.com/models에서 확인하세요.
| 모델 | 채널 성격 | 과금 | 표시 가격(할인 전) | 사용 가능 그룹 |
|---|---|---|---|---|
gpt-image-2.6-flare / gpt-image-2.6-sunburst |
공식 중계(2026-11-05 출시) | 사용량 과금 | 백만 토큰당 텍스트 입력 5달러, 이미지 입력 8달러, 출력 30달러 | Default, image2Enterprise, image2_OSS, SVIP |
gpt-image-2.5-flare / gpt-image-2.5-sunburst 및 2026-09-08 스냅샷 |
공식 중계 | 사용량 과금 | 위와 동일, 캐시 읽기 텍스트 1.25달러, 이미지 2달러 | Default, image2Enterprise, image2_OSS, SVIP |
gpt-image-2 |
공식 중계(이전 세대) | 사용량 과금 | 위와 동일 | Default, image2Enterprise, image2_OSS, SVIP |
gpt-image-2.5-all / gpt-image-2-all |
공식 역설계(ChatGPT 웹 버전) | 건당 과금 | 0.025달러/회 | Default, image2_OSS, SVIP |
gpt-image-2.5-vip 등 -vip 이름 4개 |
공식 역설계(Adobe Firefly) | 건당 과금 | 0.03달러/회 | Default, image2_OSS, SVIP |
가격 책정 API와 전체 가격표에 한 가지 불일치가 있어서 따로 봐야 해요. 가격 책정 API에서는 gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst의 quota_type이 1이고 model_price가 0.2예요. 반면 gpt-image-2.6-flare, gpt-image-2.6-sunburst와 두 2026-09-08 스냅샷은 quota_type이 0이고 model_price가 0이에요. 전체 가격표는 이 공식 중계 모델을 모두 사용량 과금으로 표시해요. 이 글의 표시 가격은 전체 가격표의 사용량 과금 기준을 따르며, 0.2를 건당 가격으로 보지 않아요. 주문 전에 콘솔에서 해당 그룹의 실제 할인 가격을 확인하세요. -all의 0.025와 -vip의 0.03은 두 출처가 일치하므로 건당 표시 가격으로 사용할 수 있어요.
공식 중계의 이미지 한 장당 비용은 출력 토큰에 따라 달라져요. 비교 페이지(문서 설명 기준)에서 제시한 일반적인 범위는 이미지 한 장당 약 0.03~0.2달러이며, 프롬프트가 길수록, size와 quality가 높을수록 비용이 커져요. 문서에는 2026-09-09의 대략적인 계산이 하나 있는데, 1024 정사각형 이미지를 2.5의 xhigh로 만들면 약 0.094달러(3122 출력 토큰), max로 만들면 약 0.211달러(7024 출력 토큰)이며, 보통 0.001달러 미만인 입력 비용은 포함하지 않아요. 문서의 결론은 이래요: 1K low 스케치라면 공식 중계가 반드시 더 비싼 것은 아니고, 중간~고화질 영역이야말로 공식 역설계의 0.025~0.03달러가 더 유리한 구간이에요.
예전 가격도 하나 알려드릴게요. 헬프 센터의 2026-04-25자 오래된 글에는 gpt-image-2-all이 0.03달러/회로 적혀 있는데, 그건 가격 인하 전 데이터예요. -all은 2026-10-10에 0.025달러로 내려갔고, 두 -all 이름도 함께 조정됐어요. 문서에서 밝힌 인하 이유는 이래요: -all이 -vip보다 더 안정적이고, -vip는 원제조사의 리스크 통제 영향을 받아 변동이 크지만 여전히 유지보수 중이며 정상적으로 사용할 수 있어요.
이미지 채널 기능 비교표
| 기능 | 공식 리버스 -all | 공식 리버스 -vip | 공식 중계 |
|---|---|---|---|
size |
전용 페이지: 긴 변 512~1536의 일반적인 너비·높이, 16의 배수가 아닌 값 포함; 2K는 정확히 지원한다고 명시하지 않음 | 30개 옵션(10가지 비율 × 1K/2K/4K), images 엔드포인트에서만 적용 | 임의의 유효한 크기, 변 길이는 16의 배수이고 비율은 3:1을 넘지 않음, 프리셋에 3840×2160 포함 |
quality |
지원하지 않음 | 채널 동작에 따르며 보장하지 않음; 2.5 두 모델은 2026-09-10 재테스트에서 max까지 확인, gpt-image-2-vip는 high까지만 |
공식적으로 보장하는 단계; xhigh/max는 2.5 두 모델에만 해당(비교 페이지) |
n |
지원하지 않음, 전달해도 그대로 n배로 과금 | 지원하지 않음, 1회 1장 | 지원 |
| 마스크 | 전체 이미지 재생성만 수행 | 전체 이미지 재생성만 수행 | mask 부분 재생성 지원 |
| 투명 배경 | background 없음, 프롬프트에만 작성 가능 |
alpha PNG 출력 가능, 문서에서 보장하지 않음 | 2.5 지원; gpt-image-2는 종료됨 |
| 속도(문서상 설명) | 전용 페이지 약 30~60초; 비교 페이지 약 90초 | gpt-image-2-vip 90~150초; flare-vip 22~138초, sunburst-vip 37~120초 |
2026-09-09 기준 2.5-flare 1K low 약 10초, sunburst 약 14초; gpt-image-2 100~120초 |
-all의 속도는 두 문서에서 설명이 달라요. 전용 페이지에는 약 30~60초, 비교 페이지에는 약 90초라고 적혀 있어요. 이 글에서는 두 숫자를 모두 적고 평균을 내지 않았어요. -all의 size도 문서 간에 맞지 않아요. 전용 페이지에는 “이제 size를 지원한다”고 되어 있는데, 비교 페이지에는 여전히 지원하지 않는다고 나와요. 이 글에서는 전용 페이지를 기준으로 볼게요. 전용 페이지는 1536 정사각형 이미지가 보간을 거쳤을 수 있으며 원본 디테일을 의미하지는 않는다고도 언급해요. 2.6의 “생성 속도 50% 향상, Flare 저화질 최대 6초”는 2026-11-05 실시간 동향에서 전한 공식 발표에서 나온 내용으로, 플랫폼이 다시 측정한 데이터는 아니에요. 2.6의 새 파라미터(complexity, SVG, GIF 등)는 OpenAI 공식 문서를 기준으로 해야 하며, 2.5의 파라미터 표를 그대로 적용할 수는 없어요.
4K 수요가 많다면 -all 전용 페이지에서 또 다른 경로를 언급해요. 바로 APIYI의 Nano Banana예요. 가격 종합표에서 nano-banana-pro와 gemini-3-pro-image 시리즈는 0.09달러/회, nano-banana-2와 gemini-3.1-flash-image는 0.055달러/회예요. 이 경로의 엔터프라이즈 그룹은 NanoBananaEnterprise와 NanoBananaReverse이며, image2Enterprise와 혼용하면 안 돼요.
이미지 채널의 토큰 유형과 그룹 우선순위, 어떻게 설정할까
많은 오류가 채널 자체 문제가 아니라 토큰 유형이나 그룹 설정이 잘못돼서 생겨요. 모든 채널은 같은 Base URL인 https://api.apiyi.com/v1을 사용해요. 엔드포인트는 /v1/images/generations와 /v1/images/edits를 권장해요. 토큰 유형 규칙에서 특히 기억할 것은 하나예요: 공식 중계는 반드시 ‘사용량 우선’을 사용해야 해요. 건별 과금 토큰으로 공식 중계를 호출하면 과금 방식이 맞지 않아 거부돼요. -all과 -vip는 ‘건별 과금’이든 ‘사용량 우선’이든 모두 괜찮아요.
| 그룹 | 배율(가격 API 2026-11-10) | 적용 채널 | 용도 | 주의 |
|---|---|---|---|---|
Default |
1 | 공식 중계, -all, -vip | 기본 우선 | 공식 중계 피크 시간에는 동시 요청이 몰려 429가 발생할 수 있어요 |
image2Enterprise |
1.2 | 공식 중계 전용 | OpenAI 업스트림 기업용 폴백 | 가속 라인도, Vertex도 아니에요. -all과 -vip는 이 그룹에 없어요 |
image2_OSS |
1 | 공식 중계, -all, -vip | URL 출력 보장 | 안정성을 높여 주지는 않아요. URL은 약 24시간 후 만료돼요 |
SVIP |
API에서 1로 읽히며, 콘솔 토큰 페이지 기준 | 공식 중계, -all, -vip | 콘솔 설명 기준 | 2026-10-29부터 한시 배율 이벤트가 종료됐어요 |
기업 그룹의 1.2배는 문서에서 이렇게 설명해요: “3,000달러를 한 번에 충전하는 대형 고객에게 20%를 추가 증정한 뒤 대략 공식 사이트 정가와 같아지는 수준”으로 설정했고, 플랫폼은 세금 비용을 계산하지 않아요. 이 그룹에서 어떤 모델이 보이는지에 대해서는 FAQ 본문 표에 gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2가 나열되어 있어요. 가격 종합표와 가격 API의 enable_groups에는 2.6 두 모델도 포함된 것으로 표시되지만, FAQ 표는 아직 동기화되지 않았어요. 문서에는 이 그룹을 별도로 신청해야 한다는 설명이 없어요. 선택할 수 없다면 콘솔 표시를 기준으로 하세요.
추천 설정은 “토큰 하나로 두 종류 모델을 커버하기”예요. 토큰 하나에는 기본 그룹 1개와 폴백 그룹을 최대 2개까지 설정할 수 있어요. 문서의 설정 방식대로 1순위를 image2Enterprise, 기본 그룹을 Default로 두세요. 그러면 공식 중계 요청은 기업 그룹을 우선 이용하고, -all과 -vip는 기업 그룹에 속하지 않으므로 Default에 남아 정상적으로 이미지를 생성해요. 구체적인 방법은 api.apiyi.com/token을 열고 토큰을 편집한 다음 그룹을 선택해 저장하는 거예요. 코드는 수정할 필요가 없어요. 검증 기준: 같은 요청으로 공식 중계 모델과 -all 모델을 각각 한 번씩 호출했을 때 두 번 모두 이미지가 생성되고, 콘솔에서 공식 중계 호출이 1.2배로 과금되어야 해요.
URL에 강하게 의존하는 서비스는 별도로 처리해야 해요. 기본 그룹에서는 2026-07 기준 response_format을 전달하지 않으면 b64_json이 반환된다고 문서에 기록되어 있어요. response_format을 url로 명시하면 링크를 받을 수 있지만, 기본 그룹은 출력 형식을 보장하지 않아요. 이런 서비스는 토큰을 image2_OSS로 전환하고 url을 명시적으로 전달한 뒤, 링크를 받는 즉시 다운로드해 보관해야 해요. 검증 기준: 응답에 url 필드가 있어야 하고, 저장한 파일이 열려야 해요.
이미지 생성 중 429, 포화, 업스트림 제공사 장애를 각각 어떻게 대비할까
같은 오류라도 원인은 전혀 다를 수 있어요. 그래서 첫 단계는 오류 본문의 error.message를 읽고如何处理할지 정하는 거예요. -vip 전용 페이지는 429를 두 가지로 나눠요. 매개변수 거부와 그룹 포화예요. -all 전용 페이지는 429를 ‘속도 제한 또는 할당량 부족’으로 두루뭉술하게 설명하고요. 실시간 동향에는 두 가지 업스트림 제공사 장애도 기록된 적이 있어요. 각각 ChatGPT 웹 버전과 OpenAI 업스트림에서 발생했죠.
아래 표는 이런 상황을 ‘어떤 오류를 보면 무엇을 먼저 할지’로 정리한 거예요.
| 보이는 증상 | 판단 | 먼저 할 일 | 확인 기준 |
|---|---|---|---|
| 官转이 Default에서 계속 429를 반환하거나 포화를 알림 | Default 그룹 혼잡 | api.apiyi.com/token에서 그룹을 image2Enterprise로 바꾸거나 우선순위를 높이세요. 모델명은 그대로예요 |
같은 요청으로 이미지 생성 성공, 과금은 1.2배 |
-vip가 429를 반환하고 message가 quality must be one of… 같은 경우 |
매개변수 거부 | 매개변수를 바꾸고 그대로 재시도하지 않기 | 수정 후 첫 요청에서 성공 |
| -vip가 429를 반환하고 message가 ‘当前分组上游负载已饱和’인 경우 | 간헐적 포화 | 지수 백오프로 재시도하면서 실시간 동향 확인 | 정해진 횟수 안에 복구되면 OK, 아니면 官转으로 전환 |
| -all/-vip에서 당일 오류가 집중되고 실시간 동향에 업스트림 제공사 장애 공지가 있는 경우 | ChatGPT 웹 또는 Adobe 업스트림 제공사 장애 | 백오프를 멈추고 모델명을 바꿔 官转으로 전환 | 官转 요청 성공, 토큰은 사용량 우선 |
官转 기업 그룹이 The server had an error while processing your request.를 반환 |
OpenAI 업스트림 장애 | 1~2회 재시도하고 그래도 안 되면 官逆으로 전환 | -all로 바꾸면 이미지 생성 가능 |
| 401 | 토큰 문제 | 토큰 확인, 재시도하지 않기 | 올바른 토큰으로 바꾸면 복구 |
gpt-image-2에서 background를 transparent로 지정하면 400 반환 |
공식적으로 해당 기능 종료 | 투명 배경은 2.5 官转에 png 또는 webp 조합으로 변경 | 반환 이미지에 알파 채널 포함 |
업스트림 제공사 장애가 의심되면 먼저 docs.apiyi.com/live에서 당일 관련 공지가 있는지 확인하고, 백오프할지 채널을 바꿀지 결정하세요. 官逆에서 官转으로 전환하는 방법은 간단해요. APIYI에서 같은 토큰을 쓰고 모델명만 바꾸면 돼요. 비교 페이지의 표현 그대로 ‘model 이름만 바꾸면 官转으로 전환할 수 있다’예요. 다만 전제 조건은 항목별로 확인해야 해요:
- 토큰 유형: 토큰이 ‘사용량 우선(按量优先)’인지 확인하세요. ‘호출 횟수 기반(按次)’ 토큰이면 요청이 거부돼요.
- 대상 모델에 맞게 필드 줄이기:
gpt-image-2로 전환할 때는 xhigh, max 등급과 투명 배경을 빼세요. -all에서 가져온 16의 배수가 아닌 크기는 16의 배수로 바꾸고, 비율은 3:1을 넘지 않게 하세요. 반대로 官转에서 -all로 되돌릴 때는quality,n,aspect_ratio,mask를 삭제해야 해요. - 타임아웃: 官转의 저화질과 중화질은 240초, high와 xhigh는 300초로 설정하세요. max와
gpt-image-2의 high는 600초로 여유 있게 잡으세요. -all과 -vip는 보수적으로 300초로 설정하세요. 입력 이미지는 먼저 1.5MB 이내로 압축하세요.
2026년 4월부터 11월까지의 과거 공지 판단표
아래 사건들은 ‘예전에 어떤 유형의 장애가 있었고, 당시 어떻게 처리했는지’를 보여 주기 위한 것일 뿐, 2026-11-10의 현재 상황을 뜻하지 않아요. 지금 포화 상태인지는 해당 시점의 오류 응답 본문과 실시간 동향을 기준으로 판단하세요.
| 날짜 | 사건(과거 공지) | 당시 처리 | 오늘 어떻게 활용할까 |
|---|---|---|---|
| 2026-04-29 | 공식 중계 기본 그룹은 여전히 429를 반환했고, image2Enterprise만 안정적이었으며 -all과 -vip는 모두 안정적이었어요 | 공식 중계는 엔터프라이즈 그룹 사용 | ‘공식 중계 기본 그룹 혼잡’의 대표 사례로 활용 |
| 2026-05-07 | 공식 중계 엔터프라이즈 그룹도 server error를 반환했고, 근본 원인은 OpenAI 업스트림이었어요 | 업스트림 복구를 기다리거나 채널 변경 | 엔터프라이즈 그룹도 업스트림이 항상 사용 가능하다고 보장할 수는 없어요 |
| 2026-05-13 | 기본 그룹 포화, image2Enterprise는 여전히 이미지 생성 가능 | 엔터프라이즈 그룹으로 전환 | 우선순위 구성 방식 지원 |
| 2026-05-23 | 기본 그룹에 리소스를 보충했고, 문서에는 굳이 엔터프라이즈 그룹으로 전환할 필요가 없다고 적혔어요 | Default로 복귀 | 혼잡은 단계적이에요 |
| 2026-09-21 | 2.5 공식 중계 기본 그룹의 동시성이 빠듯했고, 엔터프라이즈 그룹은 안정적이었어요 | 엔터프라이즈 그룹으로 전환 | 위와 같음 |
| 2026-10-15 | gpt-image-2-vip 부하가 너무 높았고, -all은 ChatGPT 웹 원본 제공사 장애로 오류가 났으며, gpt-image-2의 투명 배경은 종료됐어요(비교 페이지에는 2026-09-30으로 기록) |
공식 역방향은 우선 공식 중계로 폴백했고, 투명 배경은 2.5 공식 중계로 변경 | 원본 제공사 장애 시에는 채널을 바꿔야 하며, 무리하게 버티지 마세요 |
| 2026-11-05 | 2.6 공식 중계가 출시되어 Default 그룹을 사용할 수 있었어요 | 신규 프로젝트에서 사용할 수 있어요 | 이건 출시 공지이지 장애 공지가 아니에요 |
이미지 생성 오류, 어떤 건 재시도하고 어떤 건 하면 안 될까요
재시도 여부를 판단하는 기준은 하나예요. 오류 원인이 시간이 지나면 스스로 사라지는지 여부죠. 부하 관련 429, 5xx, 타임아웃은 저절로 회복될 수 있으니 제한된 횟수만큼 백오프를 두고 재시도할 수 있어요. 반면 파라미터 오류, 토큰 오류, 콘텐츠 거부는 스스로 사라지지 않아요. 그대로 다시 보내면 시간만 버리고, 때로는 요금이 더 나갈 수도 있어요. 2026-08-25 토픽 아카이브의 운영 기준은 “429는 재시도 가능, 콘텐츠 안전은 재시도 불필요”인데, 이 기준과도 맞아요.
- 백오프 재시도 가능: 부하 관련 429는 지수 백오프를 적용하세요. 5xx는 1~2회 재시도하고, 타임아웃은 먼저 클라이언트 타임아웃을 권장 값으로 늘려 보세요. 응답 헤더의
request-id를 기록해 두면 문제를 추적하기 좋아요. -vip 문서에는 RPM 500 이내라면 굳이 동시성 문제를 먼저 고민하지 않아도 된다고 나와 있어요. - 수정 후 다시 전송: 파라미터가 거부되면 먼저 파라미터를 고치세요. 401이면 토큰을 먼저 확인하고, 400이면 대상 모델의 필드 표와 먼저 대조해 보세요. 인증 실패와 파라미터 검증 실패는 과금되지 않아요.
- 자동 재시도 금지: 콘텐츠 거부는 두 가지로 나뉘어요. 하나는 명확한 오류를 반환하는 경우예요. 예를 들어 “예상대로 이미지를 생성하지 못했습니다. 프롬프트를 조정한 뒤 다시 시도해 주세요” 같은 경우인데, 이건 과금되지 않으니 프롬프트를 수정해야 해요. 다른 하나는 200을 반환하지만 본문이 “이 요구 사항은 수행할 수 없습니다” 같은 소프트 거부인 경우예요. 프로토콜상 정상 응답으로 처리되어 과금되고, 공식 리버스 엔드포인트도 프로토콜 계층에서 미리 알아챌 수 없어요. 같은 프롬프트를 자동으로 다시 제출하지 마세요.
질문: -all에 n=4를 전달했는데 왜 이미지는 1장만 받고 4번 과금되나요?
-all은 n을 지원하지 않지만, 전달하면 여전히 n배로 과금돼요. 전용 페이지의 예시에서는 n=3일 때 0.075달러가 차감됐고, 이미지는 여전히 1장만 반환됐어요. N장이 필요하다면 N번 병렬 호출해야 해요. 검수 기준은 콘솔의 과금 횟수가 실제로 받은 이미지 장수와 같아야 한다는 거예요.
질문: 비교 페이지에는 -all이 size를 받지 않는다고 나오는데, 실제로 전달할 수 있나요?
-all 전용 페이지를 기준으로 보면 전달할 수 있어요. 명시적으로 전달한 size는 프롬프트에 적은 크기 설명보다 우선해요. 전달하지 않거나 auto를 전달하면 원래 동작을 유지해요. 비교 페이지는 아직 동기화 업데이트가 안 된 상태예요.
질문: 기업 그룹을 쓰면 이미지 생성이 빨라지나요?
아니요. FAQ에 분명히 나와 있듯이 기업 그룹은 속도 향상용 라인이 아니에요. 기본 그룹이 혼잡할 때 또 다른 리소스 풀을 제공하는 역할일 뿐이죠. 공식 리버스 모델은 Default 그룹에 두면 돼요.
질문: 가격 API에서 공식 전환의 0.2는 호출당 가격인가요?
그렇게 이해하면 안 돼요. 가격 종합표에는 종량제로 표시되어 있고, 이 글도 종량제를 기준으로 설명해요. API가 날짜가 없는 일부 별칭에 대해 model_price 0.2를 반환하는데, 두 곳의 기준이 서로 맞지 않아요. 주문 전에 콘솔에서 실제 할인 적용 가격을 확인하세요.
질문: 2.6에 -all 또는 -vip 버전이 있나요?
2026-11-10 기준 가격 종합표와 가격 책정 API 어디에도 없으며, 이 글에서도 출시 시점에 대해 어떤 추측도 하지 않습니다.
그대로 따르면 되는 기본 설정
- 모델명:
gpt-image-2.5-all; 크기나 4K가 필요하면gpt-image-2.5-vip로, 공식 파라미터가 필요하면gpt-image-2.6-flare또는gpt-image-2.6-sunburst로 바꾸세요 - 그룹: 1순위는
image2Enterprise, 기본 그룹은Default; URL에 강하게 의존하는 업무라면 토큰을 하나 더 만들어image2_OSS를 사용하세요 - 토큰 유형: 종량제 우선 (공식 중계와 역방향 모두 호출 가능)
- 타임아웃(초): -all/-vip는 300; 공식 중계의 낮음·중간 화질은 240, high/xhigh는 300, max는 600
- Base URL:
https://api.apiyi.com/v1
이 설정대로 돌려 놓으면 평소에는 두 가지만 신경 쓰면 됩니다. 오류 본문의 error.message에 무엇이 적혀 있는지, 그리고 당일 실시간 동향에 관련 공지가 있는지예요. 위의 두 표를 참고하면 백오프 재시도할지, 요청을 수정할지, 채널을 전환할지 판단할 수 있어요.
작성자: APIYI 기술팀
기술 교류: 글에서 다루지 않은 오류를 만나면 APIYI 공식 홈페이지를 통해 문의해 주세요.request-id와 전체 오류 본문을 함께 보내 주시면 됩니다.
