Suno · 音声・音楽

OpenClaw x Suno

SunoはテキストからオリジナルのAI音楽を作成するプラットフォームで、ボーカル、楽器、歌詞を含む曲を生成します。RunAPI経由では、すべてのSunoバージョンが1つのAPIキーと呼び出し単位の課金を共有します。

9 variants から $0.01 / 回 商用利用対応
APIキーを取得 OpenClaw のドキュメントを見る

Prerequisite: npx runapi mcp install

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: 1回の生成で最大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チルビートを作成してください。
/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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/stitch_audio/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/extend_music/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/create_mashup/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/add_samples/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/cover_audio/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/inspire_music/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/text_to_music/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/remaster_audio/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/add_instrumental/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/add_vocals/<task-id> を実行します。
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 を保存します。
ステータスが completed または failed になるまで GET /api/v1/suno/text_to_sound/<task-id> を実行します。
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
利用手順

3ステップで始める

  1. モデル ID を選択

    公開モデル ID を選び、エンドポイントと現在の開始価格を確認します。

  2. RunAPI を設定

    エンドポイントを呼び出す前に RUNAPI_API_KEY を設定します。

  3. 結果を検証

    非同期エンドポイントでは、Task が終端状態になるまで同じエンドポイントをポーリングします。

OpenClaw + Suno で作れるもの

  • YouTube・SNS 向けの BGM

    プロンプトで雰囲気とジャンルを説明し、動画用のオリジナル BGM を生成します。

  • 歌詞を完成した曲として聴く

    作詞家は歌詞とスタイルの説明を渡すだけで、スタジオ入りの前に歌唱付きのデモとして確認できます。

  • ポッドキャストのオープニングとエンディング

    ポッドキャストのトーンに合ったインストのオープニング・エンディング曲を作り、複数案から最適なものを選びます。

Suno を RunAPI + OpenClaw で使う理由

  • 9 個のバリアントを 1 つの API キーで

    RunAPI の 1 つの接続から利用可能なモデルバリアントを選べるため、連携方法を変える必要がありません。

  • わかりやすい利用料金

    リクエストを送る前にカタログの現在の料金を確認できます。サブスクリプションや最低利用額はありません。

  • タスクの自動ワークフロー

    手動のポーリングコードを書かずに、統一されたタスクフローで非同期の結果を送信、確認、取得できます。

OpenClaw + Suno に関するよくある質問

Suno のプロンプトをうまく書くには？

ジャンル、雰囲気、テンポ、楽器編成を具体的に書いてください。「アコースティックギターと温かいシンセの軽快なインディーポップ」のようなプロンプトは、「楽しい曲」よりも良い結果になります。

Suno の曲を最初のクリップより長くできますか？

はい。RunAPI の Suno には曲の延長、カバー作成、曲の組み合わせなどのエンドポイントがあり、すべて同じ API キーとタスクの流れで使えます。

RunAPI 経由で Suno を使うのに Suno のアカウントは必要ですか？

いいえ。RunAPI は、RunAPI API キーと残高で Suno へのプログラムからのアクセスを提供します。Suno のアカウントや別の認証情報は不要です。

どのモデル ID を使うべきですか？

バージョン表から公開モデル ID を選択してください。各 ID で利用できるエンドポイントが同じ行に表示されます。

このガイドはチャットモデルを設定しますか？

いいえ。この Model Line はここに示すエンドポイント手順を使用し、Agent のチャットモデルとしては扱いません。

チームで構築していますか？

エンタープライズ導入、連携、技術的なご相談をお手伝いします。

お問い合わせ