모델

AI 이미지 생성 API 화면 비율: 4:5, 커스텀 크기, auto

Sume의 POST /v1/images에 aspect_ratio나 image_size를 보내세요. 4:5를 받는 모델, 커스텀 픽셀 크기를 받는 모델, 편집에서 auto를 보낼 때를 정리했습니다.

읽는 시간 5분Sume
전체 글

Sume의 AI 이미지 생성 API에서 4:5 이미지를 받으려면, 이 비율을 나열하는 모델에 aspect_ratio: "4:5"를 담아 POST /v1/images를 보내거나, 커스텀 픽셀을 받는 모델에 image_size로 커스텀 픽셀을 보내세요. 4:5는 4:3이 아니라 인스타그램 세로(1080×1350)이며, 모델마다 자체 비율 목록을 공개합니다.

비율 목록은 GET /v1/images/models가 제공하는 디스크립터에서, 규칙은 Image API 문서 (영문)와 곧 은퇴하는 Image 1.0 페이지 (영문)의 image_size 설명에서 가져왔습니다. 모두 2026-09-26에 확인했습니다.

4:5를 받는 이미지 모델은 무엇인가요?

x-ai/grok-image, google/imagen-4-fast, google/imagen-4-ultra 외에는 모든 카탈로그 모델이 4:5를 나열합니다. 목록마다 길이와 가장 가로로 긴 비율, 가장 세로로 긴 비율이 다르므로, 비율을 고정하기 전에 모델의 supported_parameters를 확인하세요.

GET /v1/images/models 디스크립터, Image API (영문), Image 1.0 (영문) 기준, 2026-09-26 확인.
모델`aspect_ratio` 값`image_size`의 커스텀 픽셀
openai/gpt-image-2, openai/gpt-image-2.5, openai/gpt-image-2.5-sunburstauto, 1:1, 16:9, 9:16, 4:3, 3:4, 5:4, 9:8, 4:5예, ChatGPT Image 한도 안에서
google/nano-banana-2auto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16, 4:1, 1:4, 8:1, 1:8아니요, 목록의 비율로 매핑
google/nano-banana-proauto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16아니요, 목록의 비율로 매핑
bytedance-seed/seedream-5-lite, bytedance-seed/seedream-4.51:1, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4, 3:2, 2:3예
bytedance-seed/seedream-4auto, 1:1, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4, 3:2, 2:3예
x-ai/grok-image2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2아니요
qwen/qwen-image, qwen/qwen-image-max, black-forest-labs/flux.2-pro, black-forest-labs/flux.2-flex, recraft/recraft-v41:1, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4, 3:2, 2:3, 21:9, 9:21, 1:2, 2:1예
google/imagen-4-fast, google/imagen-4-ultra1:1, 16:9, 9:16, 4:3, 3:4아니요
ideogram/ideogram-v31:3, 3:1, 1:2, 2:1, 9:16, 16:9, 10:16, 16:10, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 1:1아니요

커스텀 픽셀 크기는 어떻게 보내나요?

ChatGPT Image, Seedream, Flux, Qwen, Recraft 모델에서는 image_size에 { "width": 1024, "height": 1280 } 또는 문자열 "1024x1280" 형태로 넣으세요. 이 모델들에서는 image_size가 설정되면 aspect_ratio가 무시됩니다. 픽셀은 절대 size에 넣지 마세요. 이 필드는 해상도 등급의 약칭이며, 여기에 픽셀을 넣으면 400 unsupported_parameter가 반환됩니다.

문서에는 ChatGPT Image 모델용으로 쓰인 픽셀 범위가 하나 나와 있으며, 그 첫 번째 규칙은 양변이 16의 배수여야 한다는 것입니다(나머지 규칙은 GPT Image 2.5 API에 정리되어 있습니다). 1080×1350은 이 규칙을 어기므로, 이 모델들은 aspect_ratio: "4:5"를 1024×1280으로 제공합니다. 아래 예제의 크기가 바로 이 값입니다.

  • image_size는 네임드 프리셋 여섯 개도 받습니다. square_hd와 square(1:1), portrait_4_3(3:4), portrait_16_9(9:16), landscape_4_3(4:3), landscape_16_9(16:9)입니다. 이 중 4:5인 프리셋은 없습니다.
  • ChatGPT Image 모델은 image_size: "auto"도 받습니다.
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",
    "prompt": "a product photo on a linen backdrop",
    "image_size": { "width": 1024, "height": 1280 }
  }'

aspect_ratio를 auto로 보내면 어떻게 되나요?

비율 선택을 프로바이더에 맡깁니다. 문서는 편집 호출과 이미지로 이미지를 만드는 호출에서 출력이 레퍼런스를 따르도록 aspect_ratio: "auto"를 권장하며, 필드를 생략하는 것은 auto를 보내는 것과 같지 않습니다.

auto를 나열하는 모델은 6개(openai/gpt-image-2, openai/gpt-image-2.5, openai/gpt-image-2.5-sunburst, google/nano-banana-2, google/nano-banana-pro, bytedance-seed/seedream-4)뿐입니다. 다른 모델은 이 값을 거부하므로, Seedream 4.5나 Flux 2 Pro에서 편집할 때는 모델 목록에 있는 비율을 명시해야 합니다.

커스텀 크기를 지원하지 않는 모델에 픽셀을 보내면 어떻게 되나요?

Nano Banana 2와 Nano Banana Pro는 WIDTHxHEIGHT나 { width, height } 값을 네이티브 비율로 매핑하므로, 1080×1350은 4:5가 됩니다. 두 모델의 크기는 해상도 등급으로 조절하며, 이는 Nano Banana Pro API에서 다룹니다.

Imagen 4, Ideogram V3, Grok Imagine은 목록에 있는 비율로만 렌더링하며, 문서에는 이 모델들의 커스텀 픽셀 지원에 대한 설명이 없습니다.

화면 비율이 왜 거부됐나요?

값이 모델의 목록에 없거나 잘못된 필드에 들어 있기 때문입니다. 모델이 아예 나열하지 않은 파라미터는 400 unsupported_parameter를 반환하며, 다음 요청도 거부됩니다.

  • 모델 목록에 없는 비율. 예를 들어 Imagen 4의 4:5나 ChatGPT Image ID의 21:9입니다.
  • auto를 나열하지 않는 모델(예: Seedream 4.5)에 보낸 auto.
  • image_size가 아니라 size에 넣은 픽셀.
  • 공개된 픽셀 범위를 벗어난 ChatGPT Image 커스텀 크기.

출처

관련 글

작성자 Sume