---
title: Video Router
description: Seedance를 포함한 Video Router 카탈로그로 명시적 패스스루 비디오를 생성합니다.
---

새 연동은 대신 [Video generation](/models/videos)(`POST /v1/videos`)을 쓰세요 —
같은 카탈로그, 같은 Job이며 OpenRouter 호환 와이어입니다. Video Router는
그대로 남아 있고 바뀌지 않습니다.

Video Router는 비디오 생성을 위한 Sume의 **레거시 명시적 모델 카탈로그**입니다.
`GET /v1/video-router/models`에서 카탈로그 `model` id(예: Seedance)를 고르면,
Sume가 list × 1.25로 청구합니다(MiniMax H3 Max는 × 1.15). 일반적인 비동기 Job
봉투를 반환합니다.

대부분의 파트너는 대신 **[Video 1.0](/models/video)** 과 `routing_preset`을
쓰세요 — Sume가 모델을 고릅니다. 특정 카탈로그 id가 필요할 때는
[Video generation](/models/videos)을 쓰세요. Video Router는 그 별칭입니다.

기본 호출 URL:

```text
POST /v1/video-router/generate
```

카탈로그:

```text
GET /v1/video-router/models
GET /v1/video-router/models/{model_id}
```

## 언제 쓰나요

| 목표 | 접근 |
|---|---|
| Sume가 고르게 | [Video 1.0](/models/video) + `routing_preset` 권장 |
| 카탈로그 모델 고정 (예: Seedance) | Video Router + 카탈로그의 `model` |

## Video Router Job 만들기

```bash
curl -X POST https://api.sume.com/v1/video-router/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-router-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",
    "mode": "async"
  }'
```

한도는 모델마다 다릅니다 — `seedance-2.5`는 480p·720p·1080p에서 4~30초,
`wan-3.0`은 2~30초, `minimax-h3`는 네이티브 480p·768p에서 5~15초입니다
(768p가 1등 해상도이며 720p가 아닙니다). 나머지 카탈로그 모델은 모두 15초로
제한됩니다. `seedance-2`도 1080p를 지원합니다. `minimax-h3-max`(MiniMax H3
Max)는 더 빠른 768p 변형으로, 텍스트→비디오, 시작/끝 프레임 이미지→비디오,
레퍼런스→비디오(`reference_*_urls`)를 지원합니다(480p·768p, 5~15초). 요금은
제공사 정가 × 1.15이며, 다른 모델은 × 1.25입니다. `gemini-omni-flash-1.1`
(Gemini Omni Flash 1.1)은 360p·720p·1080p·4K에서 3~10초, 16:9 또는 9:16만
지원하며 네이티브 동기화 오디오가 항상 켜져 있습니다. 하나의 공통 한도를
가정하지 말고 `GET /v1/video-router/models`의 `capabilities`를 읽으세요.

## Gemini Omni Flash 1.1

`gemini-omni-flash-1.1`은 카탈로그 id 하나이며, Sume가 요청 형태를 보고
엔드포인트를 고릅니다 — 직접 고를 필요가 없습니다:

| 기능 | 보내는 필드 | 비고 |
|---|---|---|
| `text_to_video` | `prompt` | 3~10초, `resolution` 360p~4K, `aspect_ratio` 16:9 / 9:16 |
| `image_to_video` | `image_url` (+ 선택 `end_image_url`) | 동일 한도 |
| `reference_to_video` | `reference_image_urls` (≤10) 및/또는 `reference_video_urls` (≤3, 각 ≤3초) | 프롬프트에서 `<IMAGE_REF_0>`, `<VIDEO_REF_0>` 로 참조 (0부터, 목록 순서) |
| `video_to_video` (편집) | `video_url` | 프롬프트가 편집 내용을 설명; `resolution` 선택 (기본 720p); `aspect_ratio` / `duration` 없음 |

네이티브 오디오는 항상 켜져 있고(`generate_audio: false`는 거부),
`bitrate_mode`와 `reference_audio_urls`는 받지 않습니다. 요금은 해상도별
출력 초당 제공사 정가 × 1.25입니다.

편집 예시:

```bash
curl -X POST https://api.sume.com/v1/video-router/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-router-edit-001" \
  -d '{
    "model": "gemini-omni-flash-1.1",
    "prompt": "Replace the bottle with an apple. Keep everything else the same.",
    "video_url": "https://example.com/clip.mp4",
    "resolution": "720p",
    "mode": "async"
  }'
```

`video_url`은 참조가 아니라 편집 원본입니다. `image_url`, `end_image_url`,
`reference_*_urls`와 함께 보낼 수 없습니다.

전체 요청 스키마와 카탈로그 필드는 [API 레퍼런스](/api/reference)의
**Video Router** 경로를 보세요.