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

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

대부분의 파트너는 대신 **[Video 1.0](/models/video)** 과 `routing_preset`을
쓰세요 — Sume가 모델을 고릅니다. 특정 카탈로그 id가 필요할 때만 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`는 GA 전까지
공개 카탈로그에 없습니다. 하나의 공통 한도를 가정하지 말고
`GET /v1/video-router/models`의 `capabilities`를 읽으세요.

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