---
title: Music Router
description: Music Router를 통한 음악 생성 — sume/music-auto가 엔진을 고르고(현재 Lyria 3.5), 명시적 Lyria id는 그대로 통과합니다.
---

Music Router는 [Image Router](/models/images), [Video Router](/models/videos)와
같은 구조의 음악 생성 모델 표면입니다. 프롬프트를 보내면 `model`을 생략하거나
`sume/music-auto`로 지정했을 때 Sume가 엔진을 고릅니다(현재 Lyria 3.5).
`GET /v1/music-router/models` 카탈로그의 id를 지정하면 해당 엔진으로 그대로
전달됩니다.

[Music 1.0](/models/music)(`sume/music-1.0`)은 점진적으로 은퇴합니다. 기존
경로와 `job.model = sume/music-1.0`은 그대로 유지되지만, 모든 요청은 이제
Music Router를 거쳐 처리됩니다. 새 연동은 라우터를 호출하세요.

기본 호출 URL:

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

카탈로그:

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

공개 모델 id: `sume/music-router`. 라우팅 가능 id: `sume/music-auto`(기본값),
`lyria-3.5`, `lyria-3-pro`.

## 요청 필드

[Music 1.0](/models/music)과 같은 본문에 선택 필드 `model`이 추가됩니다.
알 수 없는 `model`은 `400 model_not_found`와 `catalog_url`로 거부됩니다.
`duration` / `duration_seconds`는 거부되며, 길이는 프롬프트로 지시하세요
(“a 2-minute track”).

```bash
curl -X POST https://api.sume.com/v1/music-router/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: music-router-001" \
  -d '{
    "model": "sume/music-auto",
    "prompt": "Warm lo-fi hip hop, 84 BPM, C minor. A 30-second track. Instrumental, no vocals."
  }'
```

`job.model`은 요청한 라우팅 id를 그대로 돌려주고(`sume/music-auto`는
`sume/music-auto`), `job.request.routed_model`은 실제로 실행된 카탈로그 엔진
(예: `lyria-3.5`)을 알려줍니다. Music 1.0 경로도 동일합니다.

## 요금

모든 Music Router 모델은 오디오 생성 1건당 고정 Music 요금입니다.