2026-09-26모델

세로형 9:16 영상 생성 API: 모델별 화면 비율

세로 영상은 POST /v1/videos에 aspect_ratio "9:16"을 보내세요. 9:16, 1:1, 21:9를 지원하는 Sume 모델과 픽셀 크기가 400을 반환하는 이유를 정리했습니다.

읽는 시간 4분Sume

Sume API로 9:16 세로 영상을 생성하려면 supported_aspect_ratios에 9:16이 있는 모델을 지정하고 aspect_ratio: "9:16"을 담아 POST /v1/videos를 보내세요. 카탈로그의 영상 모델은 grok-imagine-video-1.5를 제외하고 모두 이 비율을 나열하며, grok-imagine-video-1.5는 aspect_ratio를 받지 않습니다. 픽셀 크기는 쓸 수 없습니다. size는 400 unsupported_parameter를 반환합니다.

이 값은 영상 생성 문서 (영문)와 GET /v1/videos/models가 제공하는 카탈로그에서 가져왔으며, 2026-09-26에 확인했습니다.

영상 모델별로 어떤 화면 비율을 지원하나요?

aspect_ratio는 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 중 하나를 받으며, 각 모델은 그중 자신이 받는 값을 공개합니다. 디스크립터에는 aspect_ratio로 보낼 수 있는 값만 나열되며, 모델의 목록에 없는 값은 거부됩니다.

9:16: grok-imagine-video-1.5를 제외한 모든 모델이 지원합니다.
1:1: Seedance 2.x, kling-3, wan-3.0, MiniMax H3 모델들이 지원합니다.
21:9: Seedance 2.x와 MiniMax H3 모델들이 지원합니다.
3:2, 2:3, 9:21: 카탈로그에서 이 값을 나열한 모델은 없습니다.

모델별 `supported_aspect_ratios`, `GET /v1/videos/models`가 제공하는 카탈로그와 영상 생성 (영문) 기준, 2026-09-26 확인. 제출하기 전에 `GET /v1/videos/models`로 확인하세요.
모델 ID	화면 비율
`seedance-2.5`, `seedance-2`, `seedance-2-fast`, `seedance-2-mini`	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
`kling-3`	16:9, 9:16, 1:1
`wan-3.0`	16:9, 4:3, 1:1, 3:4, 9:16
`minimax-h3`, `minimax-h3-max`	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
`gemini-omni-flash-1.1`	16:9, 9:16
`grok-imagine-video-1.5`	없음: `aspect_ratio` 받지 않음

9:16 클립은 어떻게 요청하나요?

원하는 resolution, duration과 함께 aspect_ratio를 보내세요. 아래는 문서의 세로형 Video Router 예제(seedance-2.5, 720p, 12초)를 POST /v1/videos로 옮긴 것입니다.

각 필드는 자신의 목록과 따로 대조되므로, 9:16을 나열한 모델이라도 제공하지 않는 해상도나 길이는 거부할 수 있습니다.
호출은 Job id와 polling_url을 담아 202를 반환합니다. status가 completed가 될 때까지 폴링한 뒤 unsigned_urls[0]에서 내려받으세요.

curl -X POST https://api.sume.com/v1/videos \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: vertical-001" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A vertical UGC-style product clip on a desk, natural light",
    "resolution": "720p",
    "duration": 12,
    "aspect_ratio": "9:16"
  }'

size는 왜 400을 반환하나요?

size는 1280x720처럼 WIDTHxHEIGHT 형식의 정확한 픽셀 크기를 받습니다. 모든 v1 모델이 supported_sizes: null을 보고하므로, 이 형식의 size는 “size is not supported in v1 — every model reports supported_sizes: null. Use resolution and aspect_ratio.”라는 메시지와 함께 400 unsupported_parameter를 반환합니다.

대신 두 필드로 프레임을 지정하세요. 예를 들어 두 값을 모두 나열한 모델에 resolution: "1080p"와 aspect_ratio: "9:16"을 함께 보냅니다. 모델별 해상도는 4K AI 영상 생성 API에 있습니다.

모델이 원하는 비율을 나열하지 않으면 어떻게 되나요?

POST /v1/videos는 요청을 400과 오류 코드 unsupported_capability로 거부하며(예: “kling-3 does not support aspect_ratio 21:9.”), 오류 details에는 모델의 supported 비율이 나열됩니다. grok-imagine-video-1.5는 나열한 비율이 없으므로 이 모델에서는 필드를 빼세요.

Gemini Omni Flash 1.1도 원본 클립을 video_url로 보내는 편집 모드에서는 aspect_ratio를 거부합니다. 프롬프트로 영상 편집하기를 참고하세요.

기존 가로 영상을 세로로 바꿀 수 있나요?

aspect_ratio는 새로 생성하는 영상의 모양을 정합니다. 이미 있는 클립을 자르는 용도로는 문서에 영상 필터가 나와 있습니다. 영상 필터는 호스팅된 클립 하나에 dim, crop, 또는 허용 목록에 있는 픽셀 그래프를 실행하고 새 MP4를 반환합니다. 단계는 가로 영상을 세로로 바꾸기에 있습니다.

출처

작성자 Sume