도구 설정

GPT Image 2.5 Flare와 Sunburst로 이미지 생성 및 편집

GPT Image 2.5는 두 Images HTTP id입니다. 일상용 빠른 gpt-image-2.5-flare와 더 정밀하고 느린 gpt-image-2.5-sunburst입니다. 라우트는 GPT Image 2와 같은 POST /v1/images/generations 및 /v1/images/edits이며 같은 Bearer 키와 선불 잔액을 씁니다. 공식 요금도 같습니다. 이 가이드는 공식 xhigh/max/2K/4K가 아니라 실제 변환을 기록합니다.

·

생성 route 호출

GPT Image 2.5 Flare and Sunburst are image models you call over the OpenAI-compatible surface: send a prompt to /v1/images/generations with model gpt-image-2.5-flare or gpt-image-2.5-sunburst and an Authorization: Bearer header, and you get back one PNG. No separate image plan, no second key — the same sk-pool credential and prepaid balance that cover GPT, Claude and Gemini calls settle image usage too. Flare is the faster everyday id; Sunburst is slower and aimed at higher-precision edits. Official token rates match GPT Image 2.

공식 GPT Image 필드는 이 ChatGPT 풀에 맞춰 변환됩니다. user, stream, moderation, style 같은 추가 키는 400이 아니라 무시됩니다. 깨끗한 prompt에서 quality medium/high/xhigh/max/auto도 풀의 low 티어로 생성됩니다. output_format jpeg 또는 webp는 네이티브 PNG를 로컬에서 트랜스코드합니다. response_format=url은 무시되고 본문은 항상 b64_json입니다. n은 1–10일 수 있습니다. background=auto는 opaque입니다. transparent는 컷아웃 문장을 붙입니다. JSON background=transparent는 alpha 잠금이 아닙니다. size는 픽셀 잠금이 아니라 비율입니다. 2048x2048과 3840x2160은 1:1과 16:9로 매핑되며 PNG는 약 1.57메가픽셀로 남고 응답 size는 실제 IHDR입니다.

sizeProportionSteer target (inspect the PNG)
omitted or autono size steertypically ~1254×1254; not a lock
1024x1024, 1:1, 2048x20481:11254×1254
1536x1024 or 3:23:2 landscape1536×1024
1024x1536 or 2:32:3 portrait1024×1536
4:34:31448×1086
16:9, 2048x1152, 3840x216016:91672×941
9:16, 2160x38409:16944×1665

함께 보기: GPT Image 2 API로 이미지 생성 및 편집

영역 inpaint와 Responses image_generation

/v1/images/edits의 mask 필드는 무시됩니다. 일부만 바꾸거나 GPT 텍스트 모델에서 hosted image_generation 도구를 쓰려면 POST /v1/responses를 호출하세요. 편집 시 원본 PNG는 input_image, tools: [{type:"image_generation", model:"gpt-image-2.5-flare", …}]. 마스크는 input_image_mask.image_url(PNG data URL). file_id는 Files API가 없어 실패합니다.

import base64, os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APITOKEN_API_KEY"],
    base_url="https://router.apitoken.sale/v1",
)

def png_url(path):
    return "data:image/png;base64," + base64.b64encode(Path(path).read_bytes()).decode()

response = client.responses.create(
    model="gpt-5.6-sol",
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "Change only the masked region."},
            {"type": "input_image", "image_url": png_url("photo.png")},
        ],
    }],
    tools=[{
        "type": "image_generation",
        "model": "gpt-image-2.5-flare",
        "output_format": "webp",
        "partial_images": 2,
        "input_image_mask": {"image_url": png_url("mask.png")},
    }],
)
  • gpt-image-2.5-flare가 아니라 GPT 텍스트 모델(예: gpt-5.6-sol)을 /v1/responses 또는 /v1/chat/completions에 보냅니다. 이미지 id를 텍스트 lane에 보내면 /v1/images/*를 가리키는 400이지 404가 아닙니다.
  • Responses image_generation은 output_format jpeg|webp와 partial_images 1..=3을 전달합니다.
  • background=transparent는 opaque로 바뀌고 input_fidelity는 제거됩니다. Responses 정산은 텍스트 모델이며 5-leg image tariff가 아닙니다.

이미지 요금 계산

Usage legOfficial per 1M tokensPrice here
Fresh text input$5$2.50
Fresh image input$8$4
Cached text input$1.25$0.625
Cached image input$2$1
Image output$30$15
  • cached text와 image input은 일반 input 가격의 25%입니다. 공식 요금은 GPT Image 2와 같습니다.
  • gpt-image-2.5-flare는 immutable snapshot gpt-image-2.5-flare-2026-09-08의 alias입니다. gpt-image-2.5-sunburst는 gpt-image-2.5-sunburst-2026-09-08의 alias입니다.
  • 2026-09-09 production low canary는 Flare와 Sunburst 모두 HTTP 200, RGB PNG 1254×1254, image-output token 515를 반환했습니다.
  • image usage는 GPT, Claude, Gemini 호출과 같은 선불 잔액에서 결제됩니다.

자주 묻는 질문

GPT Image 2.5는 어떤 endpoint를 사용하나요?

새 이미지는 POST /v1/images/generations, reference 편집은 POST /v1/images/edits를 사용합니다.

Flare와 Sunburst의 차이는 무엇인가요?

gpt-image-2.5-flare는 더 빠른 일상 id입니다. gpt-image-2.5-sunburst는 더 정밀하고 느립니다. 둘 다 같은 Images HTTP 변환, 같은 5-leg tariff, 같은 선불 잔액을 씁니다.

기존 이미지를 편집할 수 있나요?

네. edits route가 multipart/form-data로 PNG, JPEG, WebP 최대 5개(각 50 MB 이하)를 받습니다. 필드 이름은 image를 반복하거나 image[]를 보내세요. multipart mask는 무시됩니다.

이미지 일부만 어떻게 고치나요?

POST /v1/responses에 GPT 텍스트 모델, input_image 원본 PNG, tools: [{type:"image_generation", model:"gpt-image-2.5-flare", input_image_mask:{image_url}}]를 보냅니다. file_id와 Images mask는 사용하지 마세요.

이미지 크기를 지정할 수 있나요?

비율만 지정합니다. 생략 또는 auto는 보통 약 1254×1254이지만 잠금이 아닙니다. 2K/4K는 픽셀 잠금이 아닙니다. PNG 헤더가 달라도 HTTP 200입니다.

quality xhigh나 max를 쓰면 더 높은 티어가 나오나요?

아닙니다. 깨끗한 prompt에서는 medium/high/xhigh/max/auto도 low로 생성됩니다.

별도 image 키나 잔액이 필요한가요?

아니요. 다른 지원 모델과 같은 Bearer 키와 선불 잔액을 사용합니다.

Google 또는 GitHub로 키를 만들고 $5 플랫폼 웰컴 보너스 크레딧으로 게이트웨이를 테스트하세요.