도구 설정

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 키와 선불 잔액을 사용합니다.

계정을 만들고 잔액을 충전한 다음 API 키를 생성하여 지원되는 Claude, GPT, Gemini 모델을 사용하세요.