How do I write better Suno prompts to get the genre and style I want?

Be specific about genre, mood, tempo, and instrumentation in your prompt. For example, "upbeat 120 BPM indie pop with acoustic guitar and warm synths" works better than "happy song." Use negative_tags to exclude unwanted elements like "heavy metal" or "screaming." Meta tags in the prompt help Suno understand structure.

Which Suno version should I use -- v4, v5, or v5.5?

suno-v5.5 is the latest and produces the highest quality output with better vocal clarity and mixing. suno-v4 and suno-v4.5 are cheaper and faster for draft iterations. All versions use the same text_to_music endpoint and parameters.

Can I extend a Suno song beyond the initial clip length?

Yes. Use the extend_music endpoint to continue a song from a specific timestamp. You can chain multiple extensions to build longer tracks. RunAPI also offers cover_audio to restyle existing tracks and create_mashup to combine elements from multiple songs.

Does RunAPI provide an official Suno API?

Suno does not offer a public API. RunAPI provides programmatic access to Suno v4 through v5.5 through the same API key and task lifecycle used for all other RunAPI models. No Suno account or separate credentials needed.

Can I control the voice gender and style weight?

Yes. Set vocal_gender to male or female. Use negative_tags to exclude unwanted styles. For finer control, create a persona through the generate_persona endpoint and pass the returned persona_id with persona_type set to voice or style.

OPENCLAW + SUNO

OpenClaw で Suno を使う。

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

API キーを取得ドキュメントを読む

1つの APIキー · 音楽生成エンドポイント · 非同期タスクポーリング

RunAPI を使って Suno で楽曲を生成します。

要件：
- RUNAPI_API_KEY から API キーを読み込みます。
- 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

仕組み

OpenClaw で Suno を使う3ステップ

Configure RunAPI

Set RUNAPI_API_KEY in your environment. If you already configured RunAPI in OpenClaw for chat, the same key works for Suno music generation — no extra provider setup needed.

export RUNAPI_API_KEY=runapi_xxx

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

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.

OpenClaw上のSunoとは？

Sunoはテキストプロンプトまたは歌詞からボーカル・楽器・ミキシングを含む完全な楽曲を生成するテキスト→音楽AIです。OpenClaw agentはRunAPI経由で呼び出します——SunoにはオフィシャルのパブリックAPIがないためRunAPIを通じてv4からv5.5までにプログラムでアクセスできます。