Suno · 音訊與音樂

Hermes Agent x Suno

Suno 是 AI 音樂生成平台，可根據文字描述創作原創歌曲——包含人聲、樂器與歌詞。透過 RunAPI，所有 Suno 版本共用一組 API 金鑰，並按次計費。

9 variants 起價 $0.01 / 次呼叫 可商用
取得 API Key 查看 Hermes Agent 文件

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 suno-v4：改善連貫性與頻率範圍，上限 4 分鐘。

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: 改善連貫性與頻率範圍，上限 4 分鐘
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_samples, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: 首次生成最長 8 分鐘，曲風錯誤減少 25%，人聲提升 40%
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/create_mashup, /api/v1/suno/extend_music, /api/v1/suno/add_samples, /api/v1/suno/stitch_audio, /api/v1/suno/inspire_music, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: 解鎖所有 v4.5 風格與模式，不受訂閱限制
  endpoints: /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-plus: v4.5 架構中的強化品質層級
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: CD 音質，每次生成最長 8 分鐘
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/add_instrumental, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: 每次生成最長 8 分鐘，支援聲音複製與風格訓練
  endpoints: /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: 寫一首長 2 分鐘的 lo-fi chill beat，搭配柔和鋼琴、黑膠唱片雜音與輕柔的貝斯線。
/api/v1/suno/stitch_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/stitch_audio，並儲存回傳的 Task ID。
GET /api/v1/suno/stitch_audio/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/extend_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/extend_music，並儲存回傳的 Task ID。
GET /api/v1/suno/extend_music/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/create_mashup: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/create_mashup，並儲存回傳的 Task ID。
GET /api/v1/suno/create_mashup/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/add_samples: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_samples，並儲存回傳的 Task ID。
GET /api/v1/suno/add_samples/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/cover_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/cover_audio，並儲存回傳的 Task ID。
GET /api/v1/suno/cover_audio/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/inspire_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/inspire_music，並儲存回傳的 Task ID。
GET /api/v1/suno/inspire_music/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/text_to_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/text_to_music，並儲存回傳的 Task ID。
GET /api/v1/suno/text_to_music/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/remaster_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/remaster_audio，並儲存回傳的 Task ID。
GET /api/v1/suno/remaster_audio/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/add_instrumental: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_instrumental，並儲存回傳的 Task ID。
GET /api/v1/suno/add_instrumental/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/add_vocals: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_vocals，並儲存回傳的 Task ID。
GET /api/v1/suno/add_vocals/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/suno/text_to_sound: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/text_to_sound，並儲存回傳的 Task ID。
GET /api/v1/suno/text_to_sound/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

Suno V6 現已推出。使用舊版模型 ID（v3.5–v5.5）的請求將自動路由至 V6 或 V6 Mini，價格維持不變。
模型 ID 端點 起始價格 模型目錄
suno-v4
/api/v1/suno/stitch_audio /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_samples /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/remaster_audio
$0.01 / 次呼叫 模型詳情
suno-v4.5
/api/v1/suno/remaster_audio /api/v1/suno/create_mashup /api/v1/suno/extend_music /api/v1/suno/add_samples /api/v1/suno/stitch_audio /api/v1/suno/inspire_music /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.01 / 次呼叫 模型詳情
suno-v4.5-all
/api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.12 / 次呼叫 模型詳情
suno-v4.5-plus
/api/v1/suno/cover_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.01 / 次呼叫 模型詳情
suno-v5
/api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/add_instrumental /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/add_vocals
$0.01 / 次呼叫 模型詳情
suno-v5.5
/api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/remaster_audio
$0.01 / 次呼叫 模型詳情
suno-v6
/api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/extend_music
$0.12 / 次呼叫 模型詳情
suno-v6-mini
/api/v1/suno/cover_audio /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / 次呼叫 模型詳情
suno-v6-wild
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / 次呼叫 模型詳情

驗證

輪詢，直到 Task 進入終態

選擇 <model-id> 後產生驗證命令。

設定

指南端點: <endpoint>

選擇 <model-id> 後，依端點的公開輸入契約產生請求。

其他操作

這些操作不使用模型 ID。

  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/generate_artwork
  • /api/v1/suno/generate_persona
  • /api/v1/suno/generate_midi
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_voice
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/voice_to_validation_phrase
  • /api/v1/suno/convert_audio
  • /api/v1/suno/visualize_music
  • /api/v1/suno/generate_lyrics
  • /api/v1/suno/blend_lyrics
  • /api/v1/suno/replace_section
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID，並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑，直到 Task 進入終態。

使用 Hermes Agent + Suno 可以打造什麼

  • 歌曲創作草稿本

    描述歌曲的曲風、情緒、節奏和主題，取得一段試聽帶，在正式錄製前繼續打磨。

  • 新風格翻唱

    改變現有歌曲的曲風、配器或情緒，同時保留核心旋律和結構。

  • 完整的影音流程

    在 Hermes Agent 工作流程中把 Suno 與影片模型串接，產生畫面和相搭配的原創配樂。

為什麼透過 RunAPI + Hermes Agent 使用 Suno

  • 9 個變體，一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體，無需變更現有整合。

  • 清楚的用量價格

    送出請求前查看目錄中的目前價格，無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果，無需撰寫手動輪詢程式碼。

Hermes Agent + Suno 常見問題

如何在 Hermes Agent 中設定 Suno？

使用你為聊天設定的同一個 RunAPI 提供者即可。它同時支援聊天、圖片、影片和音樂端點，Suno 不需要另外設定。

可以產生不含人聲的純音樂嗎？

可以。Suno 支援純音樂產生。本頁的請求參數說明了純音樂模式下哪些欄位有效；如果傳送了互相衝突的欄位，API 會回傳驗證錯誤。

Hermes Agent 能把 Suno 與影片模型串接嗎？

可以。Hermes Agent 可以先用影片模型產生影片，再在同一個工作流程中用 Suno 產生相搭配的配樂。

應該使用哪個模型 ID？

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

本指南會設定聊天模型嗎？

不會。此 Model Line 使用頁面所示的端點流程，不會被描述為 Agent 聊天模型。

開始在 Hermes Agent 中使用 Suno

取得 API Key 閱讀快速入門

正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

聯絡我們