取得 API 金鑰
要使用 Lyria RealTime API，你需要先取得一組 API 金鑰。以下是詳細步驟：
1
前往 Google AI Studio
用瀏覽器打開 aistudio.google.com，使用你的 Google 帳號登入。
2
點擊「Get API Key」
在左側選單或頁面頂部找到「Get API Key」按鈕，點擊進入金鑰管理頁面。
3
建立新金鑰
點擊「Create API Key」，選擇一個 Google Cloud 專案（或建立新專案），系統會自動產生一組金鑰。
4
複製並安全保存
金鑰格式類似：AIzaSyB1234567890abcdefg。請立即複製並保存到安全的地方。
⚠️ 安全提醒：API 金鑰等同密碼，絕對不要公開分享！截圖時記得馬賽克遮住。建議使用環境變數或
.env 檔案管理金鑰。
環境設定：安裝 Python 套件
在寫程式之前，需要先安裝 Google 提供的 GenAI Python SDK。這個套件就像一座橋樑，讓你的 Python 程式可以跟 Lyria RealTime 模型溝通。
安裝指令
打開終端機（命令提示字元 / Terminal），輸入以下指令：
pip install google-genai
看到以下訊息代表安裝成功：
Successfully installed google-genai-x.x.x
常見安裝問題
| 錯誤訊息 | 原因 | 解決方法 |
|---|---|---|
pip 不是內部或外部命令 |
尚未安裝 Python | 到 python.org 下載安裝，記得勾選「Add to PATH」 |
Permission denied |
權限不足 | 改用 pip install --user google-genai |
Could not find a version |
pip 版本過舊 | 先執行 pip install --upgrade pip |
💡 建議：如果你有使用虛擬環境（venv），建議在虛擬環境中安裝，避免與其他專案衝突。
進階玩法：混合風格
WeightedPrompt 最強大的用法是混合多種風格，透過不同權重比例創造獨特的音樂融合效果。
# 範例 1：爵士 + 電子環境音樂融合 await session.set_weighted_prompts(prompts=[ types.WeightedPrompt(text='jazz piano trio', weight=1.0), types.WeightedPrompt(text='electronic ambient', weight=0.3), ]) # 範例 2：古典 + Lo-fi 跨界混搭 await session.set_weighted_prompts(prompts=[ types.WeightedPrompt(text='classical strings orchestra', weight=0.7), types.WeightedPrompt(text='lo-fi chill beats vinyl', weight=0.5), ]) # 範例 3：動態漸變（播放中修改權重） # 第 0 秒：純爵士 await session.set_weighted_prompts(prompts=[ types.WeightedPrompt(text='smooth jazz', weight=1.0), types.WeightedPrompt(text='EDM drop', weight=0.0), ]) # 第 15 秒：逐漸混入 EDM 元素 await session.set_weighted_prompts(prompts=[ types.WeightedPrompt(text='smooth jazz', weight=0.5), types.WeightedPrompt(text='EDM drop', weight=0.8), ])
執行結果展示
💡 創意小提示：嘗試將看似不相容的風格混搭（如 Metal + Bossa Nova），有時會產生意想不到的驚喜效果！
完整執行流程展示
以下是程式從主選單到生成完成的完整互動過程：
********************************************* * * * Gemini Lyria RealTime 音樂生成器 * * 依照 MIDST 公式，一步步設定你的音樂 * * * * 作者：曾慶良（阿亮老師） * * © 2026 僅供課程學員學習使用 * * * ********************************************* 注意：RealTime API 僅支援純器樂生成。 ========================================================== 請選擇模式 ========================================================== [1] 推薦組合（快速模式，適合新手） [2] 自訂設定（MIDST 公式，進階玩家） [3] 人聲功能說明 [4] 關於作者 / 版權聲明 ========================================================== 請輸入編號：1 ========================================================== 推薦組合（選一個直接生成，適合新手） ========================================================== [1] 咖啡廳 Lo-fi — 放鬆的低保真音樂，適合讀書、工作 [2] 歡樂流行曲 — 開朗愉快的流行風格，適合日常背景 [3] 史詩電影配樂 — 壯闘的管弦樂，適合影片、簡報開場 [4] 深夜爵士 — 慵懶的爵士風情，適合夜晚放鬆 [5] 派對電子舞曲 — 高能量 EDM，適合運動、派對 [6] 浪漫民謠 — 溫暖柔和的民謠吉他，適合旅遊 Vlog ========================================================== 請輸入編號：4 ========================================================== 已選擇：深夜爵士 ========================================================== 風格：jazz / 情緒：relaxed calm peaceful 樂器：piano, saxophone, bass BPM：90 / 創意程度：1.0 / 長度：30 秒 ========================================================== 確認開始生成？(y/n)：y 正在連接 Lyria RealTime... 開始生成音樂，請稍候... 生成進度：#################### 100% 生成完成！ 音樂已儲存為：output_music.wav 長度：30 秒 / 格式：WAV 48kHz 立體聲
✅ 成功！程式會自動將音訊串流儲存為 WAV 檔案（48kHz 立體聲），你可以直接用任何播放器播放，或匯入 DAW 進行後製。
免費工具 A：Prompt DJ
最簡單的入門方式！打開網頁就能即時操控音樂生成，像 DJ 一樣混音。
基本資訊
- 難度：⭐ 最簡單（零門檻）
- 需求：瀏覽器 + Google 帳號
- 連結：aistudio.google.com/.../promptdj
操作步驟
- 用 Google 帳號登入
- 貼上你的 API 金鑰
- 在提示欄輸入風格，如
jazz piano, relaxed - 按下 Play 開始播放
- 邊播邊改提示詞，音樂會平滑過渡
- 用 BPM / Temperature 滑桿微調
💡 小技巧：不要一次大改提示詞，而是慢慢加入或替換關鍵字（例如先加
saxophone，再把 piano 換成 guitar），音樂轉場會更自然。
免費工具 B：MIDI DJ
跟 Prompt DJ 功能相同，但額外支援用實體 MIDI 控制器操控參數，適合有硬體設備的使用者。
基本資訊
- 難度：⭐⭐ 中等
- 需求：MIDI 控制器 + Chrome 瀏覽器（支援 Web MIDI API）
- 連結：aistudio.google.com/.../promptdj-midi
操作步驟
- 用 USB 連接 MIDI 控制器到電腦
- 用 Chrome 瀏覽器打開連結
- 允許瀏覽器存取 MIDI 裝置
- 輸入音樂風格，按 Play 播放
- 用旋鈕即時調整 BPM、風格混合比例
- 用按鍵觸發風格切換或靜音樂器
⚠️ 沒有 MIDI 控制器？直接用工具 A（Prompt DJ）就好，功能幾乎完全一樣，差別只是操控方式不同。