> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-responses-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 音乐与音效模型

> 用于歌曲、器乐曲目与音效的 Venice 音乐与音频模型，包括 ElevenLabs Music、Lyria 3 Pro 与 MiniMax Music。

<div id="model-search-placeholder" data-filter="music">
  在 API 请求中，将 `id` 值用作 `model` 参数。当前有 18 个模型可用。

  | Model | ID | Pricing | Privacy |
  | - | - | - | - |
  | ACE-Step 1.5 | `ace-step-15` | 按时长分级计价，请使用 Audio Quote API | Anonymized |
  | ElevenLabs Multilingual v2 | `elevenlabs-tts-multilingual-v2` | 请参阅 Audio Quote API | Anonymized |
  | ElevenLabs Music | `elevenlabs-music` | 按时长分级计价，请使用 Audio Quote API | Anonymized |
  | ElevenLabs Music v2 | `elevenlabs-music-v2` | 按时长分级计价，请使用 Audio Quote API | Anonymized |
  | ElevenLabs Music v2.5 | `elevenlabs-music-v2-5` | 按时长分级计价，请使用 Audio Quote API | Anonymized |
  | ElevenLabs Sound Effects | `elevenlabs-sound-effects-v2` | \$0.0023 / 秒 | Anonymized |
  | ElevenLabs TTS v3 | `elevenlabs-tts-v3` | 请参阅 Audio Quote API | Anonymized |
  | ElevenLabs TTS v4 | `elevenlabs-tts-v4` | 请参阅 Audio Quote API | Anonymized |
  | ElevenLabs TTS v4 Turbo | `elevenlabs-tts-v4-turbo` | 请参阅 Audio Quote API | Anonymized |
  | Lyria 3 Pro | `lyria-3-pro` | \$0.10 / 次生成 | Anonymized |
  | MiniMax Music 2.0 | `minimax-music-v2` | \$0.04 / 次生成 | Anonymized |
  | MiniMax Music 2.5 | `minimax-music-v25` | \$0.18 / 次生成 | Anonymized |
  | MiniMax Music 2.6 | `minimax-music-v26` | \$0.18 / 次生成 | Anonymized |
  | MMAudio V2 | `mmaudio-v2-text-to-audio` | \$0.0009 / 秒 | Anonymized |
  | Seed Audio 1.0 | `seed-audio-1-0` | \$0.0029 / 秒 | Anonymized |
  | Sonilo V1.1 Music | `sonilo-v1-1-music` | \$0.0029 / 秒 | Anonymized |
  | Sonilo V1.1 Sound Effects | `sonilo-v1-1-sound-effects` | \$0.0021 / 秒 | Anonymized |
  | Stable Audio 2.5 | `stable-audio-25` | \$0.19 / 次生成 | Anonymized |
</div>

## 模型类别

**歌曲生成：** 创建完整歌曲，支持可选歌词和人声

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

**音乐与音效：** 从文本 prompt 生成器乐或音效

* Stable Audio 2.5

**音效：** 从文本 prompt 合成音效和氛围音

* ElevenLabs Sound Effects、MMAudio V2

<Tip>
  `force_instrumental` 用于生成无人声音乐。ElevenLabs Music、MiniMax Music 2.5 和 MiniMax Music 2.6 均支持该参数——请检查 `/models` 响应中的 `supports_force_instrumental`，而不要假设只有单一模型支持。
</Tip>

<Note>
  音频生成使用异步队列系统。请按照[音乐与音效指南](/zh/guides/media/music-and-sound-effects)获取完整演练，或参阅 [Audio Queue API](/zh/api-reference/endpoint/audio/queue) 启动生成，并通过 [Audio Retrieve API](/zh/api-reference/endpoint/audio/retrieve) 获取结果。将 `model_spec.voice_changer` 设置为 `true` 的模型改用[语音转换](/zh/guides/media/voice-changer)端点。
</Note>

## 定价

价格因模型而异：

* **按次生成：** 每段音频固定价格（MiniMax Music 2.0、Stable Audio 2.5）
* **按时长分级：** 价格随时长等级变化（ElevenLabs Music、ACE-Step 1.5）
* **按秒计费：** 基于输出时长（ElevenLabs Sound Effects、MMAudio V2）

如需在生成前获得准确报价，请使用 [Audio Quote API](/zh/api-reference/endpoint/audio/quote)。

### 按时长分级的定价

按时长分级定价的模型可接受任何在模型 `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 接受 3–600 秒（最长 10 分钟），价格为每分钟 \$0.75，向上取整到最近的分钟：

| 时长范围 | 等级键 | 基础价格 |
| - | - | - |
| 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](/zh/api-reference/endpoint/audio/quote) 获取您将被收取的确切价格。

## 关键参数

| 参数 | 说明 |
| - | - |
| `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.