在 Hermes Agent 中使用 Suno。
Suno 從文字提示詞或精確歌詞生成完整歌曲 — 包含人聲、樂器和混音。v4 到 v5.5 版本皆可透過 RunAPI 使用，由於 Suno 沒有官方公開 API，RunAPI 提供了程式化存取方式。Hermes Agent 透過 custom:runapi provider 以相同的 API key 來呼叫。
Use RunAPI to generate a song with Suno.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/suno/text_to_music
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" for AI-generated lyrics from a prompt.
- Set prompt to describe the song you want.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"vocal_mode": "auto_lyrics",
"prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
"vocal_gender": "female"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "suno-v5.5"
}
三步驟在 Hermes Agent 中使用 Suno
設定 RunAPI
在 Hermes Agent 執行環境中設定 RUNAPI_API_KEY。如果你已將 RunAPI 新增為 custom:runapi provider，同一組 key 和 base_url 即可處理 Suno 音樂請求。
export RUNAPI_API_KEY=runapi_xxx
呼叫 text_to_music
向 text_to_music 端點發送 POST 請求，帶上 model 和 vocal_mode。使用 auto_lyrics 搭配 prompt 讓 AI 撰寫歌詞，使用 exact_lyrics 搭配 lyrics/style/title 提供你自己的歌詞，或使用 instrumental 搭配 style/title 生成純演奏曲目。
POST /api/v1/suno/text_to_music
輪詢結果
端點會立即回傳 task_id。歌曲生成需要 30 秒到數分鐘不等，取決於版本。輪詢任務狀態端點，直到 status 為 completed，然後讀取輸出音訊 URL。
GET /api/v1/suno/text_to_music/tsk_abc123
Suno text_to_music API 參數
| 參數 | 類型 | 說明 |
|---|---|---|
model |
string |
必填。suno-v4、suno-v4.5、suno-v4.5-all、suno-v4.5-plus、suno-v5 或 suno-v5.5。 |
vocal_mode |
string |
必填。auto_lyrics（AI 根據 prompt 撰寫歌詞）、exact_lyrics（你提供 lyrics/style/title）或 instrumental（無人聲，需提供 style/title）。 |
prompt |
string |
auto_lyrics 模式的歌曲描述。描述曲風、氛圍、節奏和主題。在 exact_lyrics 和 instrumental 模式中禁止使用。 |
lyrics |
string |
要演唱的精確歌詞。exact_lyrics 模式必填。在 auto_lyrics 和 instrumental 模式中禁止使用。 |
style |
string |
音樂風格描述，例如 lo-fi hip hop、80s synthwave。exact_lyrics 和 instrumental 模式必填。 |
title |
string |
歌曲標題。exact_lyrics 和 instrumental 模式必填。 |
vocal_gender |
string |
選填。male 或 female。 |
negative_tags |
string |
選填。要避免的風格，例如 heavy metal、screaming。 |
duration_seconds |
integer |
選填。目標時長（秒）。 |
persona_id |
string |
選填。自訂聲音或風格設定檔的 Persona ID。 |
persona_type |
string |
選填。style 或 voice。選擇 persona 類別。 |
callback_url |
string |
選填。任務完成時接收 POST 通知的 Webhook URL。 |
Hermes Agent 上的 Suno 是什麼？
Suno 是一款文字轉音樂生成器，能從文字描述或你自己的歌詞生成附有人聲、樂器和混音的完整歌曲。Hermes Agent 透過 custom:runapi provider 呼叫它，適合多步驟內容工作流程——在單次代理執行中，先用 Kling 生成影片，再用 Suno 創作匹配的配樂。由於 Suno 沒有官方公開 API，v4 至 v5.5 版本可透過此方式取得。
Suno 使用情境
錄音室製作前的音樂創作草稿
描述一個歌曲概念——風格、情感、節奏、主題——並獲得一首完整的 Demo 曲目。在投入錄音室時間前快速迭代創意，聆聽不同風格和編曲的效果。
新風格 AI 翻唱
透過 cover_audio 端點將現有曲目重新風格化。更改風格、替換樂器或調整情感，同時保留核心旋律和結構。
完整的音視覺內容流程
在 Hermes Agent 工作流程中將 Suno 與影片模型串接——生成影片素材，再創作匹配的原創配樂，製作出無需另行取得音樂授權的即發即用內容。
Suno + Hermes Agent 常見問題
auto_lyrics 根據你的 prompt 生成歌詞 — 你描述歌曲，Suno 撰寫歌詞。exact_lyrics 逐字使用你提供的歌詞，並需要 style 和 title 欄位。instrumental 生成無人聲的曲目，僅使用 style 和 title。
在 Hermes Agent 設定中新增 custom:runapi provider，將 base_url 設為 https://runapi.ai/v1，api_key 從 RUNAPI_API_KEY 讀取。同一個 provider 可處理聊天、圖片、影片和音樂端點 — 不需要為 Suno 做獨立設定。
Suno 沒有提供公開 API。RunAPI 透過與所有其他 RunAPI 模型相同的 API key 和任務生命週期，提供對 Suno v4 到 v5.5 的程式化存取。不需要 Suno 帳號或獨立的憑證。
可以。將 vocal_mode 設為 instrumental 並提供 style 和 title 欄位。prompt 和 lyrics 欄位在 instrumental 模式下必須省略。API 會強制這些跨欄位規則，如果傳送了衝突的欄位會回傳驗證錯誤。
RunAPI 提供 cover_audio（重新編排現有曲目）、extend_music（從時間戳記延伸歌曲）、create_mashup（組合多首曲目的元素）、text_to_sound（音效），以及輔助端點如 generate_lyrics、generate_persona 和 separate_audio_stems。全部共用相同的 API key 和任務生命週期。
立即在 Hermes Agent 中試用 Suno。
取得免費 RunAPI key，設定 custom:runapi provider，即可從文字描述生成包含人聲、樂器和混音的完整歌曲。