Suno · 音訊與音樂

OpenClaw x Suno

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

9 variants 由 $0.01 / 次請求 可商用
取得 API Key 查看 OpenClaw 文件

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: 創作一首 lo-fi 輕鬆節拍，配上柔和鋼琴、黑膠唱片沙沙聲及溫和低音線，長 2 分鐘。
/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 進入終態。

使用 OpenClaw + Suno 可以建立甚麼

  • YouTube 與社交媒體背景音樂

    在提示詞中描述情緒和曲風，為影片生成原創背景音樂。

  • 把歌詞變成完整歌曲

    作詞人提供歌詞和風格描述，就能在進錄音室前聽到完整演唱的試聽帶。

  • Podcast 片頭與片尾

    依 Podcast 的調性製作器樂片頭和片尾，生成多個版本後挑選最合適的。

為甚麼透過 RunAPI + OpenClaw 使用 Suno

  • 9 個變體，一個 API 金鑰

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

  • 清晰的用量價格

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

  • 自動化工作流程

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

OpenClaw + Suno 常見問題

怎麼寫出更好的 Suno 提示詞？

明確寫出曲風、情緒、節奏和配器。例如「帶木吉他和溫暖合成器的輕快獨立流行」，效果會比「開心的歌」更好。

Suno 歌曲可以在第一段之後繼續延長嗎？

可以。RunAPI 上的 Suno 提供延長歌曲、翻唱和混編等端點，全部使用同一組 API 金鑰和任務流程。

透過 RunAPI 使用 Suno 需要 Suno 帳戶嗎？

不需要。RunAPI 以你的 RunAPI API 金鑰和餘額提供 Suno 的程式化存取，不需要 Suno 帳戶或另外的憑證。

應該使用哪個模型 ID？

從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。

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

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

透過 OpenClaw 開始使用 Suno

取得 API Key 閱讀快速開始

正在與團隊一起建立？

我們可以協助企業設定、整合和技術問題。

聯絡我們