4K AI 이미지 생성 API: 해상도, 품질, 이미지 수

Sume API로 4K 이미지를 생성하려면 google/nano-banana-2, google/nano-banana-pro 중 하나에 resolution: "4K"를 담아 POST /v1/images를 보내세요. 4K 등급을 나열하는 카탈로그 모델은 이 모델들뿐입니다. ChatGPT Image 모델은 등급 대신 커스텀 크기로 한 변을 3840픽셀까지 키울 수 있으며, 모델마다 자체 quality 단계와 호출당 이미지 수인 n을 공개합니다.

아래의 등급, 단계, 상한은 GET /v1/images/models가 제공하는 디스크립터와 Image API 문서 (영문)에서 2026-09-26에 확인한 값입니다.

4K를 지원하는 이미지 모델은 무엇인가요?

resolution은 정규화된 등급(512, 1K, 2K, 4K)이고, size는 같은 등급의 약칭입니다. 등급을 하나라도 나열하는 모델은 google/nano-banana-2, google/nano-banana-pro, google/imagen-4-ultra뿐이며, Imagen 4 Ultra는 2K까지만 지원합니다. 그 밖의 모델에서는 두 필드 중 어느 쪽에 등급을 넣어도 400 unsupported_parameter가 반환됩니다. 모델별 출력 설정 전체는 다음과 같습니다.

4K 이미지는 어떻게 요청하나요?

두 4K 모델 중 어느 쪽이든 모델 목록에 있는 비율과 함께 resolution: "4K"나 size: "4K"를 보내세요. 두 필드를 모두 생략하면 이미지는 1K로 렌더링됩니다. 이 패밀리의 비율과 편집 흐름은 별도 가이드에서 다룹니다.

ChatGPT Image 모델은 등급을 나열하지 않습니다. 이 모델들의 가장 큰 프레임은 3840×2160 같은 커스텀 image_size이며, 이 크기는 3840픽셀 변 길이 상한과 8,294,400픽셀 상한에 정확히 들어맞습니다. 전체 크기 규칙은 GPT Image 2.5 API에 있습니다. size에 픽셀을 명시하면 400 unsupported_parameter가 반환됩니다.

curl -X POST "https://api.sume.com/v1/images" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "prompt": "a wide mountain landscape at dawn",
    "aspect_ratio": "16:9",
    "resolution": "4K"
  }'

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

quality는 카탈로그에 따라 허용 여부가 정해집니다. ChatGPT Image 2.5와 2.5 Sunburst는 auto, low, medium, high, xhigh, max 중 하나를, ChatGPT Image 2와 Ideogram V3는 low, medium, high 중 하나를 받습니다. ChatGPT ID 세 개는 필드를 생략하면 high로 실행됩니다. 그 밖의 모델은 quality를 나열하지 않으므로, 이 필드를 보내면 400 unsupported_parameter가 반환됩니다.

ChatGPT Image 2.5에서는 GPT Image 2.5 API에서 설명하듯 품질 단계에 따라 추정 가격도 달라집니다.

호출 한 번에 이미지를 몇 장까지 받을 수 있나요?

요청 스키마는 n을 최대 10까지 허용하지만, 모델별 n 범위는 그보다 낮습니다. 대부분의 행은 4이고, Grok Imagine(x-ai/grok-image)은 1입니다. 모델의 상한을 넘는 값은 400 오류로 거부됩니다. Seedream 4.5는 4를 나열하지만, 레퍼런스 이미지를 담은 Seedream 4.5 요청은 이미지를 한 장만 반환합니다.

output_format은 WebP만 나열하는 Recraft V4를 제외하면 어디서나 png, jpeg, webp 중 하나이며, 레퍼런스를 담은 Seedream 4.5 요청에는 적용되지 않습니다. svg는 스키마에 있지만 이를 나열하는 모델이 없고, output_compression은 400 unsupported_parameter를 반환합니다.

4K 요청이 왜 202를 반환했나요?

POST /v1/images는 최대 30초 동안 블로킹합니다. 4K, 높은 quality, 큰 n은 이 예산을 넘겨 Job 봉투와 함께 202로 돌아올 가능성이 가장 큰 설정입니다. 상태 코드로 분기하세요. GET /v1/jobs/{id}/status를 폴링한 뒤 GET /v1/jobs/{id}/result를 가져오거나, 처음부터 mode: "async"를 보내세요.

4K와 추가 이미지는 가격을 어떻게 바꾸나요?

엔드포인트 가격은 출력 이미지 단위이므로, n에 포함된 이미지마다 요금이 붙습니다. 두 4K 모델에서는 등급에 따라 이미지당 요율도 달라질 수 있고, 카탈로그 항목에는 1K 요율이 나와 있습니다. 모델별로 어떤 등급에서 요율이 달라지는지는 해당 가이드에 정리되어 있습니다.

카탈로그 항목에는 이미 Sume 마진이 포함되어 있고, 기본적으로 5.5% 에이전트 수수료가 더해집니다. 요율은 GET /v1/images/models와 API 요금에서 볼 수 있습니다. 실패하거나 취소된 생성은 청구되지 않습니다.