기본 이미지 호출을 GPT Image 2.5에서 2.6으로 옮길 때 바꾸는 것은 모델 ID뿐입니다. 엔드포인트, 토큰 요금, 권장 크기 세 가지는 그대로입니다. 주의할 부분은 2.5에는 있지만 2.6에는 없는 Batch, OpenAI의 2.5와 2.6 자료에서 서로 다르게 설명하는 Responses 이미지 도구, 그리고 OpenAI의 Image API에는 문서화되어 있지만 아직 AIHubMix의 공개 매개변수 스키마에는 없는 컨트롤인 complexity, SVG, GIF, markup입니다.
이 튜토리얼에서는 AIHubMix를 통해 대표적인 작업 하나를 진행합니다. 제목과 제품 이미지가 들어간 1536x1024 포스터입니다. 저렴한 Flare 초안 세 개를 만든 뒤 하나를 골라 Sunburst로 최종본을 렌더링하고, 모든 단계의 비용을 제시합니다. 진행하면서 큰 오류 없이 조용히 실패하는 마이그레이션 문제도 살펴봅니다.
그대로 유지되는 점
2.6 모델은 gpt-image-2.6-sunburst와 gpt-image-2.6-flare입니다. 두 모델 모두 v1/images/generations와 v1/images/edits를 통해 호출하며, 일반적인 gpt-image-2.6 별칭은 없습니다. 텍스트 입력은 토큰 100만 개당 $5, 이미지 입력은 $8, 이미지 출력은 $30으로, 2.5 및 GPT Image 2와 정확히 같습니다.
따라서 Image API를 기반으로 구축한 파이프라인은 요청 형식을 그대로 유지합니다. 달라지는 것은 모델 문자열뿐이며, 새 모델을 사용하려는 경우에만 바꾸면 됩니다. 첫날부터 변경할 주된 이유는 AIHubMix 모델 페이지에 따르면 제품군 전체가 50% 더 빠르다는 속도 주장입니다.
마이그레이션 시 주의사항
Batch가 사라졌습니다
2.5가 명확하게 우위에 있는 기능은 바로 이것입니다. GPT Image 2.5의 모델 페이지에는 v1/batch가 지원된다고 나와 있으며, Batch에서는 이미지 출력 요금이 토큰 100만 개당 $30이 아닌 $15입니다. GPT Image 2.6의 모델 페이지에는 Batch가 지원되지 않는다고 나와 있고, Batch 요금표에도 2.6 모델 두 가지가 모두 빠져 있습니다.
밤새 이미지 작업을 실행한다면 2.6으로 옮기지 마세요. 2.5를 계속 사용하거나 작업을 나눠 대화형 초안은 2.6에서, 배치 렌더링은 2.5에서 처리하세요. AIHubMix의 이미지 문서에는 Batch 엔드포인트가 없으므로, 이 결정은 OpenAI에 직접 호출하는 경우에만 해당합니다.
Responses 파이프라인은 확인이 필요합니다
OpenAI 자체 자료에서도 2.5에 대한 설명이 서로 다릅니다. 9월 변경 기록에는 Image API와 함께 Responses API 이미지 생성 도구가 나와 있지만, 2.5 모델 페이지에는 Responses가 지원되지 않는다고 표시되어 있습니다. 2.6은 상황이 더 분명합니다. 모델 페이지에는 Responses가 지원되지 않는다고 표시되어 있고, 11월 변경 기록에는 v1/images/generations와 v1/images/edits만 나와 있습니다.
코드가 Responses를 통해 2.5에 연결된다면 모델 ID를 바꾸기 전에 스모크 테스트를 추가하세요. 여기서 실패하면 오류가 분명하게 드러나지만, 테스트했을 때만 그렇습니다. 조용히 다른 모델로 대체되는 파이프라인은 400 오류보다 더 나쁩니다.
새 컨트롤은 Image API 전용입니다
이미지 생성 가이드에서는 complexity, 마크업 기반 편집, SVG 출력, 애니메이션 GIF 출력을 Image API 기능으로 소개합니다. Responses 이미지 도구에서는 이 중 어떤 기능도 사용할 수 없으며, SVG와 GIF는 생성 전용이라 /v1/images/edits에서는 둘 다 작동하지 않습니다.
각 기능에는 고유한 제약이 있습니다. SVG는 n=1이어야 하며 스트리밍, 부분 이미지, output_compression, prompt_rewriter를 지원하지 않습니다. GIF는 frame_count(기본값 9)와 frame_duration_ms(기본값 200)를 사용하며, 생성 전용이고 스트리밍, 부분 이미지, 사용자 지정 output_compression, prompt_rewriter도 지원하지 않습니다. 마크업 편집에는 원본 이미지를 첫 번째 입력 이미지로, 같은 크기의 별도 투명 PNG를 함께 제공해야 합니다. 두 이미지 모두 16,777,216픽셀을 초과할 수 없으며 마크업 파일은 50 MB로 제한됩니다. markup을 mask 또는 prompt_rewriter와 함께 사용하지 마세요.
SVG에는 별도의 결제 규칙도 있습니다. 참조 이미지에는 이미지 모델 요금이, SVG를 생성하는 데 사용된 토큰에는 작성 모델 요금이 부과됩니다. 총비용은 두 가지 모두에 따라 달라지므로 일반적인 이미지당 비용 추정치로는 계산할 수 없습니다.
품질 및 크기 문서가 서로 다릅니다
2.5의 경우 OpenAI는 auto 외에 low, medium, high, xhigh, max라는 다섯 가지 품질 수준을 명시적으로 문서화합니다. 2.6의 경우 가이드 비용 계산기에는 두 모델 모두 동일한 다섯 가지가 나오지만, API 레퍼런스는 xhigh와 max를 2.5 스냅샷에만 연결합니다. 아래 비용의 출처인 AIHubMix의 이미지당 요금표에는 low, medium, high, auto만 가격이 나와 있습니다.
현재 2.6에서 안전하게 사용할 수 있는 설정은 low, medium, high, auto입니다. 크기도 마찬가지로 주의해야 합니다. 사용자 지정 WIDTHxHEIGHT 값은 GPT Image 2와 2.5에 대해 문서화되어 있지만, 2.6 가이드에서 권장하는 크기는 1024x1024, 1536x1024, 1024x1536입니다. 2.6 문서가 일관되게 정리될 때까지는 권장 크기 세 가지를 사용하세요.
1.5에서 넘어오면 1024x1024 고품질의 비용이 더 높습니다
GPT Image 1.5와 1-mini는 2026년 12월 1일에 지원이 중단되며, 대체 모델로 2.5가 지정되어 있습니다. 주로 1024x1024 고품질로 렌더링한다면 전환 비용이 만만치 않습니다. OpenAI의 1.5 요금표에서 고품질은 $0.133이고, AIHubMix의 2.6 추정 비용은 $0.211로 약 59% 더 높습니다. medium은 $0.034에서 $0.053으로 오르지만, low는 $0.009에서 $0.006으로 낮아집니다. 1536x1024에서 1.5의 high는 $0.200이므로, 이 크기에서는 2.6의 $0.165가 더 저렴합니다.
2.6이 더 낫다고 가정하기 전에 같은 작업 구성을 2.5에서 실행해 보세요. 토큰 요금은 동일하므로 두 2.x 모델 간의 차이는 목록 가격이 아니라 토큰 사용량입니다.
AIHubMix를 통해 2.6 호출하기
AIHubMix는 2.6 모델 두 가지를 모두 제공하며 공식 요금으로 책정합니다. AIHubMix의 이미지 생성 문서에는 새로운 엔드포인트인 POST https://aihubmix.com/ai/v1/images/generations가 나와 있습니다. 이 엔드포인트는 model, prompt, n, size, output_format, image, images, mask, async, extra, 그리고 웹훅 필드 두 가지를 받습니다.
중요한 점은 품질 설정의 위치입니다. /ai/v1/images/generations에는 최상위 quality 필드가 없으며, extra 안에 넣어야 합니다.
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-flare",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
"size": "1024x1024",
"n": 3,
"extra": { "quality": "low" }
}'
응답에는 하나 이상의 출력 URL이 포함됩니다. URL은 약 30분 동안만 유효하며, 같은 Authorization: Bearer $AIHUBMIX_API_KEY 헤더를 사용해 다운로드해야 합니다.
curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png
AIHubMix 문서는 새 통합에 /ai/v1을 권장합니다. OpenAI 호환 /v1 엔드포인트는 아직 최신 모델을 지원하지 않을 수 있으며, 기존 이미지 레퍼런스의 모델 목록에는 gpt-image-2, gpt-image-1.5, gpt-image-1-mini와 DALL·E 모델이 있지만 2.6은 없습니다. 모델별 스키마에는 2.6의 /v1/images/generations 항목도 있지만, AIHubMix가 2.6용으로 문서화한 경로는 /ai/v1이며 비동기 작업과 웹훅도 지원합니다.
스키마에 노출되지 않은 항목
AIHubMix가 공개한 2.6 스키마에서 허용하는 output_format 값은 png, jpeg, webp뿐입니다. complexity, markup, frame_count, frame_duration_ms가 없으며, svg나 gif 출력도 지원하지 않습니다. 스키마는 인증 없이 https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints에서 확인할 수 있습니다. 게이트웨이를 통해 이런 기능을 사용하려면 먼저 이 스키마를 확인해야 합니다.
이는 측정된 실패가 아니라 스키마의 공백입니다. OpenAI 측에서는 기능을 문서화했으며, 게이트웨이에서도 나중에 지원할 수 있습니다. 스키마에 기능이 표시될 때까지는 SVG, GIF, 마크업 작업을 OpenAI 직접 호출로 처리할 계획을 세우세요.
예상되는 오류
| 상태 | 의미 | 대응 방법 |
|---|---|---|
| 400 | 매개변수 오류. 공급자에서 전달된 경우가 많음 | 프롬프트, 크기, n 확인 |
| 401 | 키 누락 또는 키가 유효하지 않음 | Authorization 헤더 확인 |
| 402 | 할당량 부족 | 크레딧 충전 |
| 403 | 권한 거부 | 계정, 키 권한, IP 제한 확인 |
| 429 | 속도 제한에 걸림 | 잠시 기다렸다가 재시도 |
| 503 | 요청을 처리할 채널이 없음 | 모델 ID 확인 후 나중에 재시도 |
AIHubMix의 오류 응답 본문에는 추적 ID인 tid가 포함됩니다. 지원 요청에 사용하도록 보관하고, 400 오류가 나면 요청을 바꾸지 않은 채 재시도하지 마세요. 이는 /ai/v1의 계약입니다. 기존 /v1 엔드포인트에서는 할당량 부족을 대신 403 insufficient_user_quota로 보고합니다.
작업 흐름: 초안 세 개, 최종본 하나
작업 내용은 제품 이미지와 제목이 있는 포스터입니다. 프롬프트는 그대로 두고 모델, 크기, 품질만 바꿉니다.
1단계 — Flare로 초안 만들기. 1024x1024, low 품질로 n=3을 지정해 한 번 요청하면 세 가지 방향의 결과를 얻습니다. 이미지당 예상 비용이 $0.006이므로 이 단계의 비용은 $0.018입니다.
2단계 — 하나 고르기. 작업 흐름에서 비용이 적게 드는 단계이자 모델 속도의 이점을 가장 많이 누리는 단계입니다. 한 번 호출에 초안 세 개를 만드는 것은 무리한 지출이 아니라 일반적인 예산 범위입니다.
3단계 — Sunburst로 최종본 렌더링하기. 선택한 구도를 1536x1024, high 품질로 프롬프트를 다시 지정해 렌더링합니다. 이미지당 예상 비용이 $0.165로, 가장 비싼 단계입니다. 최종본 한 장은 초안 이미지 한 장보다 약 28배, 초안 세 장을 만드는 단계보다 약 9배 비쌉니다.
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
"size": "1536x1024",
"n": 1,
"extra": { "quality": "high" }
}'
4단계 — 총비용 계산하기. 초안 비용 $0.018에 최종본 비용 $0.165를 더하면 출력 이미지 네 장에 총 $0.183이 듭니다. 최종본을 medium 품질로 렌더링하면 비용은 $0.041이고 전체 실행 비용은 $0.059입니다. 이 정도 길이의 프롬프트에서는 입력 텍스트 토큰 비용이 1센트 미만으로 추가되며, 편집 작업에는 토큰 100만 개당 $8의 이미지 입력 비용이 더해집니다.
이 수치에서 두 모델 간 비용 차이가 없음을 알 수 있습니다. AIHubMix의 이미지당 추정 비용이 같으므로 2.5에서 동일한 이미지 네 장을 만들어도 비용은 같습니다. 2.6을 사용하는 이유는 초안 작업을 더 빠르게 반복할 수 있고, 나중에 SVG 또는 GIF 작업을 OpenAI로 옮길 수 있기 때문이지, 요금이 더 저렴해서가 아닙니다.
마이그레이션 체크리스트
- 새 모델을 사용할 곳에서는
gpt-image-2.5-sunburst와gpt-image-2.5-flare를 2.6 ID로 바꾸고, Batch 작업은 2.5에 그대로 두세요. - 파이프라인에서 Responses 이미지 도구를 사용하는지 확인하세요. 2.6에는 Image API만 문서화되어 있습니다.
- 2.6 문서가 정리될 때까지 품질 설정은
low,medium,high,auto로 제한하고 크기는 권장값 세 가지를 사용하세요. - AIHubMix의
/ai/v1에서는 품질을extra에 지정하세요. 2.6의 경우 AIHubMix가 새 통합에 권장하는 경로인/ai/v1을 사용하세요. - Bearer 헤더를 사용해 30분 이내에 출력 URL에서 파일을 다운로드하세요.
complexity, markup, SVG, GIF가 스키마에 명시되기 전까지는 AIHubMix를 통해 사용할 수 있다고 가정하지 마세요.- 1.5를 사용 중이라면 12월 1일 지원 중단에 대비해 예산을 계획하고 고품질 생성 비용을 다시 확인하세요.
FAQ
GPT Image 2.6을 사용하려면 엔드포인트를 변경해야 하나요?
OpenAI API에서는 그럴 필요가 없습니다. 2.5와 마찬가지로 v1/images/generations와 v1/images/edits를 사용하며, 모델 ID만 달라집니다. AIHubMix에서는 위에 설명한 대로 /ai/v1/images/generations를 사용하세요.
GPT Image 2.6은 2.5보다 저렴한가요?
아니요. 토큰 요금은 동일합니다. 텍스트 입력 토큰 100만 개당 $5, 이미지 입력 토큰 100만 개당 $8, 이미지 출력 토큰 100만 개당 $30입니다.
GPT Image 2.6에서 Batch를 사용할 수 없는 이유는 무엇인가요?
OpenAI의 2.6 모델 페이지에는 Batch가 지원되지 않는다고 표시되어 있으며, Batch 요금표에도 2.6이 아닌 2.5만 나와 있습니다. Batch는 2.5가 여전히 더 나은 선택인 가장 뚜렷한 작업 흐름입니다.
AIHubMix에서 품질을 어떻게 설정하나요?
2.6에서는 /ai/v1/images/generations의 extra.quality에 지정하세요. OpenAI 호환 /v1/images/generations에는 최상위 quality 필드가 있지만, AIHubMix는 새 통합에 /ai/v1을 권장하므로 2.6에는 /ai/v1을 사용하세요.
AIHubMix를 통해 SVG나 GIF를 생성할 수 있나요?
현재 스키마에 따르면 불가능합니다. 스키마에는 png, jpeg, webp만 나와 있으며 complexity, markup, 프레임 수, SVG/GIF 출력은 포함되어 있지 않습니다. 이러한 기능은 OpenAI Image API 문서에 안내되어 있으므로 게이트웨이를 통해 사용할 계획이라면 먼저 스키마를 확인하세요.
AIHubMix 출력 URL은 얼마나 오래 유효한가요?
약 30분입니다. 동일한 Bearer 토큰으로 파일을 다운로드한 다음 직접 저장하세요.
GPT Image 1.5는 어떻게 되나요?
2026년 12월 1일에 지원이 중단됩니다. OpenAI는 2.5를 대체 모델로 안내하지만, 1024x1024 고품질 생성의 경우 2.6은 1.5보다 이미지당 비용이 더 높고, 1536x1024에서는 더 낮습니다.
계속 읽기: GPT Image 2.6 시리즈
비교 글에서는 요금표와 속도 관련 주장을 살펴보고 2.5가 여전히 앞서는 부분을 짚습니다. 업그레이드 여부를 아직 결정하지 못했다면 여기서 시작해 보세요.
GPT Image 2.6 vs 2.5: 업그레이드할 가치가 있을까요?
