Sume의 GPT Image 2.5 API: 품질·크기·마스크·레퍼런스

Sume에서 GPT Image 2.5 API를 쓰려면 model: "openai/gpt-image-2.5"(문서에서 Flare라고 부르는 ChatGPT Image 2.5) 또는 "openai/gpt-image-2.5-sunburst"에 prompt를 더해 POST /v1/images를 보내세요. 두 ID 모두 텍스트로 이미지를 생성하거나 최대 16장의 레퍼런스 이미지로 편집할 수 있으며, max까지 올라가는 quality 단계, 커스텀 픽셀 크기, 선택적 mask_url, background 설정을 지원합니다.

이 글의 내용은 모두 Image API 문서 (영문)와 Sume가 GET /v1/images/models에서 제공하는 카탈로그에서 가져왔으며, 2026-09-26에 확인했습니다. ChatGPT Image 2(openai/gpt-image-2)도 계속 선택할 수 있지만, 옵션 목록이 더 짧습니다.

Flare와 Sunburst는 무엇이 다른가요?

문서와 카탈로그에는 두 ID에 보낼 수 있는 내용의 차이가 나와 있지 않습니다. 두 ID 모두 텍스트로 이미지 생성, 최대 16개의 이미지 레퍼런스, 선택적 mask_url, background: auto|transparent|opaque를 지원합니다. 카탈로그는 두 ID를 ChatGPT Image 2.5와 ChatGPT Image 2.5 Sunburst로 부르고, 똑같은 파라미터 디스크립터를 붙이며, 같은 토큰 요율로 가격을 매깁니다. 두 모델의 이미지가 어떻게 다른지는 문서에 나와 있지 않으므로, 하나를 고정하기 전에 직접 쓰는 프롬프트로 둘을 비교해 보세요.

어떤 품질 단계를 설정할 수 있나요?

2.5 ID 두 개는 모두 quality 값으로 auto, low, medium, high, xhigh, max 중 하나를 받습니다. 필드를 생략하면 요청은 high로 실행됩니다. ChatGPT Image 2는 low, medium, high만 받습니다.

품질 단계는 토큰 추정치에 반영되므로 가격이 달라집니다. 높은 설정은 이미지 대신 202 Job 봉투를 반환할 수 있는 느린 설정에도 속합니다. 이 경우는 4K, 품질, 이미지 수에서 다룹니다.

ChatGPT Image 2.5는 어떤 크기를 받나요?

image_size에는 네임드 프리셋, auto, 또는 { width, height }나 WIDTHxHEIGHT 형태의 커스텀 픽셀을 넣으세요. 커스텀 크기는 양변이 16의 배수이고, 긴 변이 3840 이하이며, 화면 비율이 3:1 이내이고, 전체 픽셀 수가 655,360–8,294,400이어야 합니다. 3840×2160은 변 길이 상한과 픽셀 수 상한에 정확히 들어맞습니다.

aspect_ratio도 쓸 수 있습니다. ChatGPT Image ID 세 개가 나열하는 값은 auto, 1:1, 16:9, 9:16, 4:3, 3:4, 5:4, 9:8, 4:5입니다. 네임드 프리셋이 없는 비율은 규칙에 맞는 커스텀 픽셀로 바뀝니다. 1080×1350은 16의 배수 규칙을 통과하지 못하므로 4:5는 1024×1280이 되고, 5:4는 1280×1024, 9:8은 864×768이 됩니다. 다른 모델 패밀리는 화면 비율과 커스텀 크기에서 비교합니다.

마스크로 이미지를 어떻게 편집하나요?

원본 이미지는 input_references에, 공개 HTTPS 마스크 이미지는 mask_url에 넣고, 출력이 원본을 따르도록 aspect_ratio: "auto"를 쓰는 편이 좋습니다. mask_url과 background를 나열하는 것은 2.5 ID뿐이며, ChatGPT Image 2는 두 필드 중 어느 쪽을 보내도 400 unsupported_parameter로 응답합니다. 레퍼런스 전반의 규칙은 레퍼런스 이미지 기반 이미지 생성 API에서 다룹니다.

curl -X POST "https://api.sume.com/v1/images" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "prompt": "replace the sky with a soft sunset",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/photo.jpg" } }
    ],
    "mask_url": "https://example.com/mask.png",
    "quality": "medium",
    "aspect_ratio": "auto"
  }'

ChatGPT Image 2.5와 ChatGPT Image 2는 어떻게 다른가요?

두 모델은 커스텀 크기 범위, 비율 목록, 네임드 프리셋이 같습니다. 2.5 ID는 여기에 auto, xhigh, max 품질, 레퍼런스 슬롯 여섯 개, 마스크, background를 더합니다.

GPT Image 2.5는 어떻게 과금되나요?

토큰 기준으로 과금됩니다. 출력 이미지 토큰, 입력 이미지 토큰, 입력 텍스트 토큰에 요금이 붙고, Flare와 Sunburst의 요율은 같습니다. 두 ID의 카탈로그 pricing 항목은 high 품질, 1024×1024 출력 기준의 단일 금액입니다. 실제 요청은 각각 크기와 품질로 비용을 추정하며, 입력 토큰 수도 추정치입니다.

Sume가 금액을 예약(선차감)할 때 quality: "auto"는 max 기준으로, auto 크기는 출력 토큰 상한 기준으로 예약합니다. 응답의 usage.cost는 지갑에 청구된 USD 금액이며, 실패하거나 취소된 생성은 청구되지 않습니다. 카탈로그 항목에는 Sume 마진이 포함되어 있고, 기본적으로 5.5% 에이전트 수수료가 더해집니다. API 요금을 참고하세요.