Suno API
テキストプロンプトからボーカル、楽器、歌詞を持つ曲を作成するAI音楽生成向けにSuno APIにアクセスできます。
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"prompt": "ソフトなピアノ、ビニールのクラックル、穏やかなベースラインを持つ2分間のlo-fiチルビートを作成してください。"
}'
import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.textToMusic.run({
model: "suno-v5.5",
prompt: "ソフトなピアノ、ビニールのクラックル、穏やかなベースラインを持つ2分間のlo-fiチルビートを作成してください。",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->textToMusic->run([
'model' => 'suno-v5.5',
'prompt' => 'ソフトなピアノ、ビニールのクラックル、穏やかなベースラインを持つ2分間のlo-fiチルビートを作成してください。',
]);
require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.text_to_music.run(
model: "suno-v5.5",
prompt: "ソフトなピアノ、ビニールのクラックル、穏やかなベースラインを持つ2分間のlo-fiチルビートを作成してください。"
)
npx skills add runapi-ai/suno -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Sunoはテキストプロンプトからボーカル、楽器、歌詞を含む完全な曲を生成します。V3.5からV5.5にわたり、各世代で放送品質のトラックをあらゆる音楽ジャンルで生成します。
- 品質とレイテンシ目標に合わせたモデルバリアント
- 統合 API key
- Model skill に docs、schema、セットアップメモを同梱
- 失敗した生成は課金されません
バリアント
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
アプリ開発用に Suno skill をインストール
モデル docs、schema、料金メモ、セットアップ手順をコード作業環境に読み込みます。
# Install the model skill for app development workflows
npx skills add runapi-ai/suno -g
Install the Suno skill for this app: 1. Add runapi-ai/suno with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
この model skill で構築する方法
モデルを選ぶ
出力タイプ、品質基準、レイテンシ目標に合うモデルとバリアントを選びます。
一度だけ認証
対応するすべてのモデルに RunAPI key を使います。
skill をインストール
機能実装の前に model skill をコード作業環境へ追加します。
出力を受け取る
task ID でポーリングするか、生成完了時の callback を処理します。
Suno の位置づけ
SunoはテキストからオリジナルのAI音楽を作成するプラットフォームで、ボーカル、楽器、歌詞を含む曲を生成します。RunAPI経由では、すべてのSunoバージョンが1つのAPIキーと呼び出し単位の課金を共有します。
RunAPI 経由で Suno を使う理由
1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
Skill-ready
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
予測しやすい請求
呼び出し前に従量料金を確認できます。
よくある質問
このモデルはどう呼び出しますか?
model skill をインストールし、RunAPI key とセットアップメモに従ってください。
失敗した生成は課金されますか?
失敗した生成は課金されません
アプリケーションから呼び出せますか?
はい。コード作業環境に model skill をインストールし、モデル機能を追加するときに利用してください。