--- title: RunAPI経由でWorkBuddyでSunoを使う — 音楽MCPガイド | RunAPI description: RunAPI MCP serverを通じてWorkBuddyでSuno v4からv5.5を使って楽曲を生成。1つのkey、ボーカルモード対応、非同期ポーリングはワークベンチエージェントが処理。 url: https://runapi.ai/ja/workbuddy-suno.md canonical: https://runapi.ai/ja/workbuddy-suno locale: ja site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-suno zh-CN: https://runapi.ai/zh-CN/workbuddy-suno es: https://runapi.ai/es/workbuddy-suno ja: https://runapi.ai/ja/workbuddy-suno de: https://runapi.ai/de/workbuddy-suno fr: https://runapi.ai/fr/workbuddy-suno pt-BR: https://runapi.ai/pt-BR/workbuddy-suno ko: https://runapi.ai/ko/workbuddy-suno it: https://runapi.ai/it/workbuddy-suno nl: https://runapi.ai/nl/workbuddy-suno pl: https://runapi.ai/pl/workbuddy-suno tr: https://runapi.ai/tr/workbuddy-suno zh-TW: https://runapi.ai/zh-TW/workbuddy-suno zh-HK: https://runapi.ai/zh-HK/workbuddy-suno ar: https://runapi.ai/ar/workbuddy-suno x-default: https://runapi.ai/workbuddy-suno model: suno --- > HTML version: https://runapi.ai/ja/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # WorkBuddyでSunoを使いましょう。 Sunoはテキストプロンプトまたは正確な歌詞から、ボーカル・楽器・ミキシングを含む完全な楽曲を生成します。v4からv5.5までRunAPI経由で利用でき、SunoはオフィシャルのパブリックAPIを持っていないためRunAPIがAPIアクセスを提供しています。RunAPIをMCP serverとして一度追加するだけで、WorkBuddyエージェントが非同期タスクを処理し、完成した音声URLを返します。 - [API キーを取得](https://runapi.ai/ja/login) - [ドキュメントを読む](https://runapi.ai/ja/docs/guides) MCP server 1台 · テキストからフル楽曲生成 · 非同期ポーリング処理済み ### プロンプト ```text Using the runapi MCP server, generate a song with Suno. Requirements: - Call the Suno text_to_music tool exposed by the runapi MCP server. - Set model to "suno-v5.5". - Set vocal_mode to "auto_lyrics" so the lyrics are written from my brief. - Prompt: an upbeat indie pop track about coding late at night, warm synths and acoustic guitar, female vocals. - The task is async — keep polling until the status is "completed", then give me the audio URL. ``` ### MCP設定 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### レスポンス ```json { "task_id": "tsk_abc123", "status": "completed", "model": "suno-v5.5", "output": { "audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3", "title": "Midnight Compile", "duration_seconds": 187 } } ``` ## WorkBuddyでSunoを使う3ステップ 1. **RunAPIをMCPサーバーとして追加する** - WorkBuddyを起動する環境にRUNAPI_API_KEYを設定し、https://runapi.ai/mcp をストリーマブルHTTPで指すrunapi という名前のMCPサーバーを登録します。Sunoは他のすべてのRunAPIモデルと並んで呼び出し可能な音楽ツールとして表示されます。別の音楽サービスを接続する必要はありません。 `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **エージェントに曲を説明する** - WorkBuddyに自然な言葉でやりたいことを伝え、モードを指定します。AIが歌詞を書く場合はauto_lyricsとpromptを、自分の歌詞を使う場合はexact_lyricsとlyrics/style/titleを、ボーカルなしの場合はinstrumentalとstyle/titleを使います。エージェントはあなたの指示をSunoツール呼び出しにマッピングします。 `vocal_mode: auto_lyrics` 3. **エージェントにポーリングと音声収集を任せる** - 曲の生成は非同期で、バージョンによって30秒から数分かかります。ワークベンチエージェントはタスクのステータスがcompletedになるまでポーリングし、出力音声URLを会話に投稿します。task_idを自分で操作する必要はありません。 `"status": "completed"` ## Sunoのtext_to_musicパラメーター | パラメータ | 型 | 説明 | | --- | --- | --- | | `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モードで必須。 | | `vocal_gender` | `string` | オプション。maleまたはfemale。 | | `negative_tags` | `string` | オプション。除外したいスタイル（例：heavy metal、screaming）。 | ## WorkBuddyのSunoとは？ Sunoは、テキストプロンプトまたは自分の歌詞から、ボーカル・楽器・ミキシングを含む完全な楽曲を生成するテキスト-to-ミュージックAIです。ジャンル・ムード・テンポを説明するだけでフルトラックが得られる作曲スケッチパッドとして機能します。SunoはRunAPI MCPサーバーを通じてWorkBuddyからアクセスできます。Sunoには公式の公開APIがないため、ワークベンチエージェントはチャットや画像と同じキーでv4からv5.5のバージョンにプログラム的にアクセスできます。 ## Sunoのユースケース - **YouTubeとソーシャルメディア向けBGM** - ムードとジャンルを説明してオリジナルのバックグラウンドトラックをリクエストしましょう。ライセンス料も著作権の問題もなく、トラックはあなたのコンテンツ向けに新たに生成され、URLがWorkBuddyに返ってきます。 - **歌詞を完全な楽曲として視聴する** - 作詞家は自分の言葉をWorkBuddyに貼り付け、スタイルの説明とともにexact_lyricsモードをリクエストするだけで、完成した楽曲として演奏されたものを聴けます。スタジオ時間の前のデモ制作に最適です。 - **ポッドキャストのイントロとアウトロ** - ジャンル・ムード・長さを指定して、ポッドキャストのトーンに合ったインストゥルメンタルのイントロ・アウトロ音楽を作成できます。1つの会話でエージェントに複数のバリエーションを生成させて、最適なものを選びましょう。 ## Suno + WorkBuddy よくある質問 ### Sunoで希望のジャンルとスタイルを得るためのプロンプトの書き方は？ WorkBuddyへの指示にジャンル・ムード・テンポ・楽器を具体的に記述してください。例えば「アコースティックギターとウォームなシンセを使った120BPMの明るいインディーポップ」は「明るい曲」よりも効果的です。不要な要素（ヘビーメタルやスクリームなど）を除外するためにnegative_tagsをエージェントに渡すよう依頼できます。 ### Sunoのバージョンはv4・v5・v5.5のどれを使うべきですか？ suno-v5.5が最新版で、より高いボーカルの明瞭度とミキシングで最高品質の出力を生成します。suno-v4とsuno-v4.5はドラフトの反復処理において安価で高速です。すべてのバージョンは同じrunapi MCPサーバーの背後にあるため、切り替えはプロンプトで別のバージョンを指定するだけです。 ### WorkBuddyでタスクを自分でポーリングする必要がありますか？ 不要です。Sunoのタスクは非同期ですが、ワークベンチエージェントがライフサイクルを管理します。MCPツールを通じてタスクを作成し、ステータスがcompletedになるまでポーリングし、音声URLを会話に投稿します。曲を説明して待つだけです。 ### RunAPIは公式のSuno APIを提供していますか？ Sunoは公開APIを提供していません。RunAPIはSuno v4からv5.5へのプログラムアクセスを、他のすべてのRunAPIモデルと同じAPIキーおよびタスクライフサイクルで提供します。Sunoアカウントや別途の認証情報は不要です。 ### ボイスの性別とスタイルの比重を制御できますか？ はい。vocal_genderにmaleまたはfemaleを指定し、negative_tagsで不要なスタイルを除外できます。より細かい制御が必要な場合は、personas endpointでペルソナを作成し、返されたpersona_idをpersona_typeにvoiceまたはstyleを設定して渡します。 - [WorkBuddyセットアップガイド →](https://runapi.ai/ja/workbuddy.md) - まだ接続していませんか？WorkBuddy用のRunAPI MCPセットアップガイドから始めてください。 - [RunAPI上のSuno →](https://runapi.ai/ja/models/suno.md) - 全Sunoバージョン、料金、利用可能なendpointをご覧ください。 ## 今すぐWorkBuddyでSunoを試す 無料のRunAPIキーを取得し、WorkBuddyにMCPサーバーを追加して、曲を説明するだけ。ワークベンチエージェントがボーカル・楽器・ミキシングを含むフルトラックを返します。 [モデルを見る →](https://runapi.ai/ja/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ja/.md) ### プロダクト - [モデルカタログ](https://runapi.ai/ja/models.md) - [料金](https://runapi.ai/ja/pricing.md) - [プロバイダー](https://runapi.ai/ja/models#all-models) ### 開発者 - [ドキュメント](https://runapi.ai/ja/docs/guides) - [SDK](https://runapi.ai/ja/sdk.md) - [CLI](https://runapi.ai/ja/cli.md) - [MCP Server](https://runapi.ai/ja/mcp.md) - [x402](https://runapi.ai/ja/x402.md) ### ガイド - [Claude Code と Cursor](https://runapi.ai/ja/claude-code-vs-cursor.md) - [Cursor API セットアップ](https://runapi.ai/ja/cursor-api-setup.md) - [RunAPI と OpenRouter の比較](https://runapi.ai/ja/openrouter-alternative.md) ### 会社 - [エンタープライズ](https://runapi.ai/ja/contact.md) - [お問い合わせ](https://runapi.ai/ja/contact.md) ### 法務 - [利用規約](https://runapi.ai/ja/terms.md) - [プライバシー](https://runapi.ai/ja/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ja", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ja", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ja/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ja", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/jaicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "SoftwareApplication", "name": "WorkBuddy向け RunAPI Suno", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP serverを通じてWorkBuddyでSuno v4からv5.5を使って楽曲を生成。1つのkey、ボーカルモード対応、非同期ポーリングはワークベンチエージェントが処理。", "url": "https://runapi.ai/ja/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Sunoで希望のジャンルとスタイルを得るためのプロンプトの書き方は？", "acceptedAnswer": { "@type": "Answer", "text": "WorkBuddyへの指示にジャンル・ムード・テンポ・楽器を具体的に記述してください。例えば「アコースティックギターとウォームなシンセを使った120BPMの明るいインディーポップ」は「明るい曲」よりも効果的です。不要な要素（ヘビーメタルやスクリームなど）を除外するためにnegative_tagsをエージェントに渡すよう依頼できます。" } }, { "@type": "Question", "name": "Sunoのバージョンはv4・v5・v5.5のどれを使うべきですか？", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5が最新版で、より高いボーカルの明瞭度とミキシングで最高品質の出力を生成します。suno-v4とsuno-v4.5はドラフトの反復処理において安価で高速です。すべてのバージョンは同じrunapi MCPサーバーの背後にあるため、切り替えはプロンプトで別のバージョンを指定するだけです。" } }, { "@type": "Question", "name": "WorkBuddyでタスクを自分でポーリングする必要がありますか？", "acceptedAnswer": { "@type": "Answer", "text": "不要です。Sunoのタスクは非同期ですが、ワークベンチエージェントがライフサイクルを管理します。MCPツールを通じてタスクを作成し、ステータスがcompletedになるまでポーリングし、音声URLを会話に投稿します。曲を説明して待つだけです。" } }, { "@type": "Question", "name": "RunAPIは公式のSuno APIを提供していますか？", "acceptedAnswer": { "@type": "Answer", "text": "Sunoは公開APIを提供していません。RunAPIはSuno v4からv5.5へのプログラムアクセスを、他のすべてのRunAPIモデルと同じAPIキーおよびタスクライフサイクルで提供します。Sunoアカウントや別途の認証情報は不要です。" } }, { "@type": "Question", "name": "ボイスの性別とスタイルの比重を制御できますか？", "acceptedAnswer": { "@type": "Answer", "text": "はい。vocal_genderにmaleまたはfemaleを指定し、negative_tagsで不要なスタイルを除外できます。より細かい制御が必要な場合は、personas endpointでペルソナを作成し、返されたpersona_idをpersona_typeにvoiceまたはstyleを設定して渡します。" } } ] }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "HowTo", "name": "RunAPI経由でWorkBuddyでSunoを使う方法", "description": "WorkBuddyにRunAPIをMCP serverとして追加し、ワークベンチエージェントに楽曲の内容を説明して、非同期のSunoタスクを実行させ、完成した音声URLを受け取ります。", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPIをMCPサーバーとして追加する", "text": "WorkBuddyを起動する環境にRUNAPI_API_KEYを設定し、https://runapi.ai/mcp をストリーマブルHTTPで指すrunapi という名前のMCPサーバーを登録します。Sunoは他のすべてのRunAPIモデルと並んで呼び出し可能な音楽ツールとして表示されます。別の音楽サービスを接続する必要はありません。", "url": "https://runapi.ai/ja/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "エージェントに曲を説明する", "text": "WorkBuddyに自然な言葉でやりたいことを伝え、モードを指定します。AIが歌詞を書く場合はauto_lyricsとpromptを、自分の歌詞を使う場合はexact_lyricsとlyrics/style/titleを、ボーカルなしの場合はinstrumentalとstyle/titleを使います。エージェントはあなたの指示をSunoツール呼び出しにマッピングします。", "url": "https://runapi.ai/ja/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "エージェントにポーリングと音声収集を任せる", "text": "曲の生成は非同期で、バージョンによって30秒から数分かかります。ワークベンチエージェントはタスクのステータスがcompletedになるまでポーリングし、出力音声URLを会話に投稿します。task_idを自分で操作する必要はありません。", "url": "https://runapi.ai/ja/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "ホーム", "item": "https://runapi.ai/ja" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy向け RunAPI Suno", "item": "https://runapi.ai/ja/workbuddy-suno" } ] } ] ```