---
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`, `elevenlabs-music-2.5`, `minimax-music-2.6`,
`lyria-2`, `stable-audio-2.5`, `ace-step`.
`sume/music-auto`는 Sume가 엔진을 고릅니다(현재 Lyria 3.5).

## 요청 필드

[Music 1.0](/models/music)과 같은 본문에 선택 필드 `model`이 추가됩니다.
알 수 없는 `model`은 `400 model_not_found`와 `catalog_url`로 거부됩니다.
`duration`은 거부됩니다. `duration_seconds`(초)는 카탈로그 행에
`capabilities.duration_seconds`가 있는 모델에서만 받습니다
(`elevenlabs-music-2.5`, `stable-audio-2.5`, `ace-step`).
나머지 모델은 길이를 프롬프트로 지시하세요(“a 2-minute track”).
`image_url`은 `sume/music-auto`, `lyria-3.5`, `lyria-3-pro`만 받습니다.

```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건마다 같은 고정 크레딧을 사용합니다.
현재 크레딧은 [API 요금표](https://www.sume.com/pricing/api)에서 확인하세요.