HERMES + SUNO

Hermes Agent で Suno を使う。

Suno はテキストプロンプトまたは正確な歌詞から、ボーカル・楽器・ミキシングを含む完全な楽曲を生成します。v4 から v5.5 までの各バージョンが RunAPI 経由で利用でき、Suno には公式の公開 API がないため RunAPI が API アクセスを提供します。Hermes Agent は custom:runapi プロバイダー経由で、チャットと同じ API キーでこれを呼び出します。

API キーを取得 ドキュメントを読む
1つの APIキー · 音楽生成エンドポイント · 非同期タスクポーリング 
RunAPI を使って Suno で楽曲を生成します。

要件：
- RUNAPI_API_KEY から API キーを読み込みます。
- base_url を https://runapi.ai/v1 として custom:runapi プロバイダーを使用します。
- POST https://runapi.ai/api/v1/suno/text_to_music を呼び出します。
- model を "suno-v5.5" に設定します。
- プロンプトから AI が歌詞を生成するように vocal_mode を "auto_lyrics" に設定します。
- prompt に作りたい楽曲を記述します。
- このタスクは非同期です。返された task_id を status が "completed" になるまでポーリングします。
- 完了したら、レスポンスの output から音声の URL を読み取ります。

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"
}
curlコマンドをコピーしてテスト suno
仕組み

Hermes Agent で Suno を使う3ステップ

1

Configure RunAPI

Set RUNAPI_API_KEY in the environment where Hermes Agent runs. If you already added RunAPI as a custom:runapi provider, the same key and base_url handle Suno music requests.

export RUNAPI_API_KEY=runapi_xxx
2

Call text_to_music

Send a POST to the text_to_music endpoint with the model and vocal_mode. Use auto_lyrics with a prompt for AI-written lyrics, exact_lyrics with lyrics/style/title for your own words, or instrumental with style/title for no vocals.

POST /api/v1/suno/text_to_music
3

Poll for the result

The endpoint returns a task_id immediately. Song generation takes 30 seconds to several minutes depending on version. Poll the task status endpoint until the status is completed, then read the output audio URL.

GET /api/v1/suno/text_to_music/tsk_abc123
パラメータ

Suno text_to_music API パラメータ

パラメータ 型 説明
model string Required. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, or suno-v5.5.
vocal_mode string Required. auto_lyrics (AI writes lyrics from prompt), exact_lyrics (you provide lyrics/style/title), or instrumental (no vocals, requires style/title).
prompt string Song brief for auto_lyrics mode. Describe genre, mood, tempo, and subject. Forbidden in exact_lyrics and instrumental modes.
lyrics string Exact lyrics to sing. Required for exact_lyrics mode. Forbidden in auto_lyrics and instrumental modes.
style string Music style description, e.g. lo-fi hip hop, 80s synthwave. Required for exact_lyrics and instrumental modes.
title string Song title. Required for exact_lyrics and instrumental modes.
vocal_gender string Optional. male or female.
negative_tags string Optional. Styles to avoid, e.g. heavy metal, screaming.
duration_seconds integer Optional. Target duration in seconds.
persona_id string Optional. Persona ID for custom voice or style profiles.
persona_type string Optional. style or voice. Selects the persona category.
callback_url string Optional. Webhook URL that receives a POST when the task completes.

Hermes AgentのSunoとは？

Sunoはテキスト説明や歌詞からボーカル・楽器・ミキシングを含む完全な楽曲を生成するテキスト→音楽ジェネレーターです。Hermes Agentはcustom:runapi provider経由で呼び出し、マルチステップコンテンツワークフローに適しています——Klingで動画を生成してからSunoでマッチするオリジナルサウンドトラックを作成する、といった処理を1回のagent実行で完結できます。

Sunoの活用例

スタジオ制作前の作曲スケッチ

楽曲コンセプト——ジャンル・気分・テンポ・テーマ——を説明して完全なデモトラックを受け取ります。スタジオ時間を費やす前に素早くアイデアを反復し、異なるスタイルとアレンジがどう聴こえるか確認します。

新スタイルのAIカバー

cover_audioエンドポイントで既存の楽曲を新しくアレンジします。コアなメロディーとストラクチャーを保持しながらジャンルを変え・楽器を入れ替え・気分をシフトします。

完全な視聴覚コンテンツパイプライン

Hermes Agentワークフローで動画モデルとSunoを連結します——動画映像を生成してからマッチするオリジナルサウンドトラックを作成し、別途の音楽ライセンスなしにそのまま公開できるコンテンツを制作します。

FAQ

Suno + Hermes Agent に関する質問

Hermes Agent の基本設定

まだ設定していませんか？Hermes Agent の RunAPI セットアップガイドから始めましょう。

Hermes Agent セットアップガイド →

Suno モデルカタログ

すべての Suno バージョン、価格、利用可能なエンドポイントを確認する。

Suno モデル →

今すぐ Hermes Agent で Suno を試す。

無料の RunAPI キーを取得し、custom:runapi プロバイダーを設定して、テキストの説明からボーカル・楽器・ミキシングを含む完全な楽曲を生成しましょう。

モデルを見る →