# Lyria 提示指南

Gemini API 提供两种使用 Lyria 生成音乐的方法：

* **Lyria 3.5 & Lyria 3 Clip**：30 秒剪辑或带有歌词和人声的完整长度歌曲的非流式生成。参见 [使用 Lyria 3.5 生成音乐](/docs/music-generation).
* **Lyria RealTime**：通过 WebSocket 进行实时、交互式音乐流和实时转向。参见 [使用 Lyria RealTime 实时音乐生成](/docs/realtime-music-generation).

两种模型都会响应描述性文本提示、音乐术语和结构方向。本指南介绍了如何为批量生成和实时引导编写有效的提示。

## 提示基础知识  {% #prompt-fundamentals %}

您的提示可以是一个简短的短语：

```none
A folk song about cute cats avoiding puddles, female vocals, acoustic guitar, sound of rain
```

或者一个结构化的、详细的描述：

```none
A 1980s-style synth-pop track with a driving beat, shimmering synthesizers, and a catchy, anthemic chorus. The song should have a retro-futuristic feel with modern production polish. Upbeat tempo around 120 BPM, clear verse-chorus structure, and a memorable instrumental hook. The lyrics describe getting ready for a party.
```

简短和详细的提示都会产生强有力的结果。使用以下策略引导模型获得您想要的确切声音。

## 流派和风格  {% #genre-and-style %}

以主要类型引导你的提示。您可以结合流派来创建独特的混合体：

* 金属与嘻哈的融合
* 死亡金属与歌剧人声相结合
* 带有黑暗电子无人机元素的古典室内乐
* 现代电子舞曲 (EDM) 与欧洲流行音乐的混合

您还可以指定音乐时代或地区变体：

* 20 世纪 90 年代初期的嘻哈音乐
* 20 世纪 60 年代法国 yé-yé 流行音乐
* 20 世纪 80 年代后朋克和新浪潮
* 2000年代主流R&B
* 柏林最小科技或湾区 hyphy

### 类型关键词  {% #genre-keywords %}

在 Lyria 3.5 和 Lyria RealTime 的提示中使用这些已识别的流派术语：

* **电子舞曲**: `Acid House, Breakbeat, Chillout, Chiptune, Deep House, Drum & Bass, Dubstep, EDM, Electro Swing, Glitch Hop, Hyperpop, Minimal Techno, Moombahton, Psytrance, Synthpop, Techno, Trance, Trip Hop, Vaporwave`
* **嘻哈与 R&B**: `808 Hip Hop, Boom-Bap, Contemporary R&B, G-funk, Grime, Lo-Fi Hip Hop, Neo-Soul, New Jack Swing, Trap Beat`
* **摇滚与另类**: `Alternative Country, Blues Rock, Classic Rock, Funk Metal, Garage Rock, Indie Folk, Indie Pop, Post-Punk, 60s Psychedelic Rock, Shoegaze, Surf Rock`
* **爵士乐、灵魂乐和放克乐**: `Acid Jazz, Afrobeat, Bossa Nova, Disco Funk, Funk, Jazz Fusion, Latin Jazz`
* **民俗与传统**: `Bengal Baul, Bhangra, Bluegrass, Celtic Folk, Cumbia, Indian Classical, Irish Folk, Merengue, Polka, Reggae, Reggaeton, Renaissance Music, Salsa`
* **古典与原声**: `Baroque, Orchestral Score, Piano Ballad`

## 乐器和纹理  {% #instruments-and-textures %}

Lyria 自动为请求的流派选择合适的乐器。如果您想要特定的工具或不寻常的组合，请明确声明它们：

```none
A dance track with a driving beat, shimmering synthesizers, and a catchy, anthemic chorus. A saxophone solo enters during the bridge.
```

描述乐器如何发声和相互作用来设定情绪和质感：

* 扭曲的 303 低音线穿过清脆、紧绷的踩镲
* 温暖的模拟合成器垫在干燥、亲密的原声吉他下膨胀
* 由多层法兹吉他构成的音墙，带有遥远的、混响浸透的人声

### 仪器关键词  {% #instrument-keywords %}

* **键盘和合成器**: `Buchla Synths, Clavichord, Dirty Synths, Harpsichord, Mellotron, Moog Oscillations, Ragtime Piano, Rhodes Piano, Smooth Pianos, Spacey Synths, Synth Pads`
* **贝斯和鼓**: `303 Acid Bass, 808 Hip Hop Beat, Boomy Bass, Conga Drums, Drumline, Funk Drums, Precision Bass, Tabla, TR-909 Drum Machine`
* **吉他和弦乐**: `Banjo, Balalaika, Bouzouki, Cello, Charango, Dulcimer, Fiddle, Flamenco Guitar, Guitar, Harp, Koto, Lyre, Mandolin, Pipa, Shamisen, Shredding Guitar, Sitar, Slide Guitar, Viola Ensemble, Warm Acoustic Guitar`
* **管乐与铜管乐**: `Alto Saxophone, Bagpipes, Bass Clarinet, Didgeridoo, Harmonica, Ocarina, Trumpet, Tuba, Woodwinds`
* **打击乐**: `Bongos, Djembe, Glockenspiel, Hang Drum, Kalimba, Maracas, Marimba, Mbira, Steel Drum, Vibraphone`

## 歌曲结构和时间安排  {% #structure-and-timing %}

对于 Lyria 3.5，使用标签或箭头定义歌曲进程：

* `[Intro] -> [Verse 1] -> [Chorus] -> [Verse 2] -> [Chorus] -> [Bridge] -> [Outro]`
* 从安静的钢琴前奏开始，构建出充满活力的诗句，停顿片刻的沉默，然后爆发出合唱。

您可以指导能量动态和转换：

* 通过预副歌营造紧张气氛，然后在爆炸性的副歌之前陷入沉默
* 整首歌曲逐渐渐强，每部分添加一种乐器
* 过了桥突然停下来，接着是无伴奏合唱

您还可以提示特定的时间标记：

* 构建到 12 秒的节拍下降
* 人声样本重复每个 4 小节
* 合唱在 22 秒开始

## 歌词和演唱  {% #lyrics-and-vocals %}

Lyria 3.5 默认生成带有歌词的声乐曲目。您可以提供自己的歌词，要求模型生成歌词，或者请求乐器曲目。

### 使用自己的歌词  {% #own-lyrics %}

直接在提示下方包含您的歌词 `Lyrics:` 标头。标记每个部分以指导声音传递：

```none
Lyrics:

[Intro]
Ooooh, yeah

[Verse 1]
Early morning rain on the window pane
City lights wash away the pain
Walking down this empty street again

[Chorus]
We keep moving on (moving on)
Until the morning light
Everything will be alright
```

使用括号来伴奏人声、回声或即兴表演，例如 `(moving on)`.

### 指导生成的歌词  {% #generated-lyrics %}

当要求 Lyria 3.5 写歌词时，概述叙述、情感或关键短语：

```none
The lyrics describe driving down the Pacific Coast Highway at sunset. The mood is nostalgic and reflective. Include an uplifting, anthemic chorus about second chances and starting over.
```

对于电子和舞蹈类型，要求短的重复声乐钩子：

```none
An upbeat dance-pop track with a repetitive, high-energy vocal hook: "Feel the rhythm all night long."
```

### 声音传递和歌手简介  {% #vocal-delivery %}

指定性别、音域和音色以实现精确传递：

* **女高音**：清晰、水晶般的音色，敏捷、高亢的传递。明亮的色调能够营造出通风、呼吸的纹理。
* **女低音**：丰富、温暖、沙哑的低音域。烟熏音色，深情、洪亮的胸声。
* **男高音**：明亮、锐利、充满活力。年轻的音色具有高传送力，可穿透密集的混音。
* **男男中音**：深沉、天鹅绒般光滑的胸声，带有温暖、舒缓、低吟的声音。
* **风化摇杆**：刺耳、坚韧的音色让人想起 20 世纪 90 年代的另类摇滚。原始的情感强度和紧张的高音。

### 非抒情的声音效果  {% #vocal-effects %}

您还可以提示口语对话、声带和采样效果：

* 在节拍开始之前，老式的广播声音介绍了这首歌
* 掉落前有低语声，随后是高能合成器
* 切碎、变调的声音样本作为乐器节奏元素循环播放

## 音乐参数  {% #musical-parameters %}

使用标准音乐属性完善您的提示：

* **节奏 (BPM)**：直接设置速度（例如 `120 BPM`, `slow tempo around 72 BPM`, `fast 160 BPM`).
* **调和音阶**：指定根音和调性（例如 `in G major`, `in D minor`, `in C pentatonic`).
* **心情和气氛**：使用描述性情感形容词： `Ambient, Bright, Chill, Dark, Dreamy, Emotional, Ethereal, Euphoric, Funky, Groovy, Melancholic, Nostalgic, Ominous, Psychedelic, Relaxed, Soulful, Triumphant, Upbeat, Whimsical`

## 提示Lyria RealTime  {% #realtime-prompting %}

Lyria RealTime用途 **加权提示** 而不是单个整体提示字符串。这使您可以动态地混合多种音乐影响，并通过 WebSocket 连接连续引导音乐。

### 加权提示结构  {% #weighted-prompts %}

每个加权提示由描述性文本短语和浮点权重组成：

```python
prompts = [
    types.WeightedPrompt(text="minimal techno", weight=1.0),
    types.WeightedPrompt(text="deep sub bass", weight=0.6),
    types.WeightedPrompt(text="shimmering hi-hats", weight=0.4),
]
```

### 实时转向策略  {% #steering-strategies %}

* **混合流派**：通过分配平衡的权重来融合不同的风格：* `ambient synth pads (weight: 0.8)` + `lo-fi hip-hop drums (weight: 0.6)`

  * `flamenco guitar (weight: 0.7)` + `deep house groove (weight: 0.5)`

* **动态过渡**：要平滑地过渡音乐，请随时间调整提示权重：1. 从 `chill jazz piano (weight: 1.0)`。 2. 逐步添加 `electronic breakbeat (weight: 0.3)`。 3. 增加 `electronic breakbeat` 到 `0.8` 同时降低 `chill jazz piano` 到 `0.3`.

* **分层元素**：将乐器标签和情绪标签分开，以便您可以单独调整它们： * 提示 1： `bossa nova guitar (weight: 0.9)`

  * 提示符2： `warm acoustic bass (weight: 0.7)`
  * 提示符3： `subtle vinyl crackle (weight: 0.3)`

## 提示示例  {% #example-prompts %}

### Lyria 3.5 示例

* **低保真学习节拍**：``无 30 第二个洛菲嘻哈节拍，带有尘土飞扬的乙烯基爆裂声、柔和的罗德钢琴和弦、82 BPM 中轻松的 Boom-Bap 鼓节奏以及温暖的直立低音线。仅乐器演奏。

  ```
  
  ```

* **流行歌曲**: ```无一首乐观、感觉良好的 G 大调独立流行歌曲，122 BPM。明亮的原声吉他弹奏、强劲的底鼓、拍手声以及温暖的女声和声。歌词描述了与朋友一起难忘的夏季公路旅行。

  ```
  
  ```

* **电影赛博朋克**：```无黑暗，电影赛博朋克合成波，110 BPM，D 小调。严重扭曲的低音，不祥的琶音模拟合成器，遥远的金属打击乐，以及高潮时空灵的女声膨胀。

  ```
  
  
  ```

### Lyria RealTime 转向装置

```python
# Initial high-energy groove
await session.set_weighted_prompts(
    prompts=[
        types.WeightedPrompt(text="techno groove", weight=1.0),
        types.WeightedPrompt(text="acid 303 bass", weight=0.8),
    ]
)

# Transition to a melodic breakdown
await session.set_weighted_prompts(
    prompts=[
        types.WeightedPrompt(text="ambient synth pads", weight=1.0),
        types.WeightedPrompt(text="subtle reverberant piano", weight=0.7),
        types.WeightedPrompt(text="techno groove", weight=0.2),
    ]
)
```

## 后续步骤  {% #whats-next %}

* [使用 Lyria 3.5 生成音乐](/docs/music-generation)：使用 Interactions API 生成完整歌曲和 30 秒剪辑。
* [使用 Lyria RealTime 实时音乐生成](/docs/realtime-music-generation)：通过 WebSocket 构建实时、交互式音乐流应用程序。
