> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Venice API is OpenAI-compatible: use any OpenAI SDK with the base URL `https://api.venice.ai/api/v1` and a Venice API key, or pay per request from a USDC wallet through x402 with no account.
> Read model IDs from `GET /models` or `GET /models/traits` at runtime instead of hardcoding them from memory or from these pages. Models are added and retired often.
> Every model's price is in https://docs.venice.ai/pricing.md. Quote video and audio jobs with `POST /video/quote` or `POST /audio/quote` before you queue them.
> Search these docs from an MCP client at https://docs.venice.ai/mcp. The full agent guide is https://docs.venice.ai/agents.md.

# 음악 & 사운드 이펙트 모델

> ElevenLabs Music, Lyria 3 Pro, MiniMax Music 등 노래, 연주곡, 효과음용 Venice 음악·오디오 모델.



API 요청에서 `id` 값을 `model` 매개변수로 사용하세요. 현재 19개의 모델을 사용할 수 있습니다.

| Model | ID | Pricing | Privacy |
| - | - | - | - |
| [ACE-Step 1.5](https://docs.venice.ai/ko/models/ace-step-1-5.md) | `ace-step-15` | 길이 등급별: Audio Quote API 사용 | Anonymized |
| [ElevenLabs Multilingual v2](https://docs.venice.ai/ko/models/elevenlabs-multilingual-v2.md) | `elevenlabs-tts-multilingual-v2` | 1,000자당 \$0.115 | Anonymized |
| [ElevenLabs Music](https://docs.venice.ai/ko/models/elevenlabs-music.md) | `elevenlabs-music` | 길이 등급별: Audio Quote API 사용 | Anonymized |
| [ElevenLabs Music v2](https://docs.venice.ai/ko/models/elevenlabs-music-v2.md) | `elevenlabs-music-v2` | 길이 등급별: Audio Quote API 사용 | Anonymized |
| [ElevenLabs Music v2.5](https://docs.venice.ai/ko/models/elevenlabs-music-v2-5.md) | `elevenlabs-music-v2-5` | 길이 등급별: Audio Quote API 사용 | Anonymized |
| [ElevenLabs Sound Effects](https://docs.venice.ai/ko/models/elevenlabs-sound-effects.md) | `elevenlabs-sound-effects-v2` | 초당 \$0.0023 | Anonymized |
| [ElevenLabs TTS v3](https://docs.venice.ai/ko/models/elevenlabs-tts-v3.md) | `elevenlabs-tts-v3` | 1,000자당 \$0.115 | Anonymized |
| [ElevenLabs TTS v4](https://docs.venice.ai/ko/models/elevenlabs-tts-v4.md) | `elevenlabs-tts-v4` | 1,000자당 \$0.092 | Anonymized |
| [ElevenLabs TTS v4 Turbo](https://docs.venice.ai/ko/models/elevenlabs-tts-v4-turbo.md) | `elevenlabs-tts-v4-turbo` | 1,000자당 \$0.046 | Anonymized |
| [ElevenLabs Voice Changer](https://docs.venice.ai/ko/models/elevenlabs-voice-changer.md) | `elevenlabs-voice-changer` | 길이 등급별: Voice Changer Quote API 사용 | Anonymized |
| [Lyria 3 Pro](https://docs.venice.ai/ko/models/lyria-3-pro.md) | `lyria-3-pro` | 생성당 \$0.10 | Anonymized |
| [MiniMax Music 2.0](https://docs.venice.ai/ko/models/minimax-music-2-0.md) | `minimax-music-v2` | 생성당 \$0.04 | Anonymized |
| [MiniMax Music 2.5](https://docs.venice.ai/ko/models/minimax-music-2-5.md) | `minimax-music-v25` | 생성당 \$0.18 | Anonymized |
| [MiniMax Music 2.6](https://docs.venice.ai/ko/models/minimax-music-2-6.md) | `minimax-music-v26` | 생성당 \$0.18 | Anonymized |
| [MMAudio V2](https://docs.venice.ai/ko/models/mmaudio-v2.md) | `mmaudio-v2-text-to-audio` | 초당 \$0.00092 | Anonymized |
| [Seed Audio 1.0](https://docs.venice.ai/ko/models/seed-audio-1-0.md) | `seed-audio-1-0` | 초당 \$0.002875 | Anonymized |
| [Sonilo V1.1 Music](https://docs.venice.ai/ko/models/sonilo-v1-1-music.md) | `sonilo-v1-1-music` | 초당 \$0.002875 | Anonymized |
| [Sonilo V1.1 Sound Effects](https://docs.venice.ai/ko/models/sonilo-v1-1-sound-effects.md) | `sonilo-v1-1-sound-effects` | 초당 \$0.00207 | Anonymized |
| [Stable Audio 2.5](https://docs.venice.ai/ko/models/stable-audio-2-5.md) | `stable-audio-25` | 생성당 \$0.19 | Anonymized |

## 모델 카테고리

**노래 생성:** 선택적 가사 및 보컬 지원으로 완전한 노래 생성

* ACE-Step 1.5, ElevenLabs Music, MiniMax Music 2.0

**음악 & 사운드 이펙트:** 텍스트 프롬프트에서 기악 음악 또는 사운드 이펙트 생성

* Stable Audio 2.5

**사운드 이펙트:** 텍스트 프롬프트에서 오디오 효과와 앰비언트 사운드 합성

* ElevenLabs Sound Effects, MMAudio V2

> [!TIP]
>
> `force_instrumental`은 보컬 없이 음악을 생성합니다. ElevenLabs Music, MiniMax Music 2.5, MiniMax Music 2.6에서 지원됩니다 — 단일 모델이라고 가정하지 말고 `/models` 응답의 `supports_force_instrumental`을 확인하세요.

> [!NOTE]
>
> 오디오 생성은 비동기 큐 시스템을 사용합니다. 전체 워크스루는 [음악 & 사운드 이펙트 가이드](https://docs.venice.ai/ko/guides/media/music-and-sound-effects.md)를 따르고, 생성을 시작하려면 [Audio Queue API](https://docs.venice.ai/ko/api-reference/endpoint/audio/queue.md)를, 결과를 가져오려면 [Audio Retrieve API](https://docs.venice.ai/ko/api-reference/endpoint/audio/retrieve.md)를 참조하세요. `model_spec.voice_changer`가 `true`로 설정된 모델은 대신 [보이스 체인저](https://docs.venice.ai/ko/guides/media/voice-changer.md) 엔드포인트를 사용합니다.

## 가격

가격은 모델에 따라 다릅니다:

* **생성당:** 오디오 클립당 고정 가격 (MiniMax Music 2.0, Stable Audio 2.5)
* **길이 등급별:** 길이 등급에 따라 가격이 조정됨 (ElevenLabs Music, ACE-Step 1.5)
* **초당:** 출력 길이 기준 가격 (ElevenLabs Sound Effects, MMAudio V2)

생성 전 정확한 견적을 받으려면 [Audio Quote API](https://docs.venice.ai/ko/api-reference/endpoint/audio/quote.md)를 사용하세요.

### 길이 등급 가격

길이 등급 가격이 적용되는 모델은 모델의 `min_duration`–`max_duration` 범위 내 모든 `duration_seconds`를 허용합니다. **단**, 모델이 `duration_options`도 보고하는 경우에는 정확히 그 값들만 허용되며 다른 값은 `400`을 반환합니다. 예를 들어 ACE-Step 1.5는 `60`, `90`, `120`, `150`, `180`, `210`만 허용하므로, `duration_seconds: 75`는 광고된 범위 안에 있어도 거부됩니다. `min_duration`/`max_duration`으로 판단하기 전에 항상 `duration_options`를 확인하세요.

가격은 요청된 길이가 어느 등급에 해당하는지에 따라 결정됩니다. 등급 범위는 `/models` 응답의 `pricing.durations` 아래에 각 등급에 대한 `min_seconds`와 `max_seconds`와 함께 반환됩니다.

예를 들어, ElevenLabs Music은 분당 \$0.75로 3–600초(최대 10분)를 허용하며, 가장 가까운 분으로 반올림됩니다:

| 길이 범위 | 등급 키 | 기본 가격 |
| - | - | - |
| 3–60s | `60` | \$0.75 |
| 61–120s | `120` | \$1.50 |
| 121–180s | `180` | \$2.25 |
| 181–240s | `240` | \$3.00 |
| 241–300s | `300` | \$3.75 |
| 301–360s | `360` | \$4.50 |
| 361–420s | `420` | \$5.25 |
| 421–480s | `480` | \$6.00 |
| 481–540s | `540` | \$6.75 |
| 541–600s | `600` | \$7.50 |

이는 마크업 전 기본 가격입니다. 청구될 정확한 가격을 받으려면 [Audio Quote API](https://docs.venice.ai/ko/api-reference/endpoint/audio/quote.md)를 사용하세요.

## 주요 매개변수

| 매개변수 | 설명 |
| - | - |
| `prompt` | 생성할 오디오의 텍스트 설명 |
| `lyrics_prompt` | 보컬 모델용 노래 가사 (모델에 `lyrics_required=true`가 있을 때 필수) |
| `duration_seconds` | 출력 길이(초) |
| `force_instrumental` | 보컬 없이 생성 (지원되는 경우) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.