Suno API

RouteAPI は Suno AI 音楽生成の統合 REST API を提供します。テキストから音楽生成、曲の延長、ボイスクローニング、ステム分離などをサポートします。

Base URL: https://api.routeapi.ai
認証: Authorization: Bearer sk-xxxx

ワークフロー概要

Suno の音楽生成は非同期です。 典型的なフロー：

タスクを送信 /suno/audios へ → task_id を受信
2-3秒待機 してからポーリング開始
3-5秒ごとにポーリング /suno/tasks で action: "retrieve"
status が success になったら → audio_url を取得

タスクステータス

ステータス	意味	次のステップ
`submitted`	送信済み、待機中	ポーリング継続
`queued`	キュー中	ポーリング継続
`in_progress`	生成中	ポーリング継続
`success`	✅ 完了	`data.audio_url` を取得
`failed`	❌ 失敗	`error` フィールドを確認

クイックスタート

ステップ1：タスクを送信

curl -X POST "https://api.routeapi.ai/suno/audios" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v5-5",
    "prompt": "A cheerful summer pop song with piano and guitar",
    "async": true
  }'

ステップ2：結果をポーリング

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

ステップ3：オーディオを取得

{
  "id": "task_xxxxx",
  "status": "success",
  "data": {
    "audio_url": "https://cdn.suno.ai/xxx.mp3",
    "duration": 183.5
  }
}

サポートされるモデル

モデル ID	最大長	lyric 上限	style 上限
`chirp-v5-5`	8分	5000文字	1000文字
`chirp-v5`	8分	5000文字	1000文字
`chirp-v4`	150秒	3000文字	200文字

POST /suno/audios

コアエンドポイント。18種類のオーディオ操作をサポートします。

コアパラメータ

フィールド	型	デフォルト	説明
`model`	string	`chirp-v4`	生成モデル、`chirp-v5-5` を推奨
`action`	string	`generate`	操作タイプ
`async`	boolean	`false`	`true` を強く推奨

アクションタイプ

Action	説明	必須フィールド
`generate`	プロンプトから新しい音楽を生成	`prompt`
`extend`	既存のオーディオを延長	`audio_id` + `continue_at`
`cover`	既存曲を新しいスタイルで再解釈	`audio_id`
`stems`	ボーカル + インストゥルメンタルに分離	`audio_id`
`remaster`	オーディオをリマスターして品質向上	`audio_id`

完全なアクションタイプについては英語または中国語のドキュメントを参照してください。

POST /suno/tasks

タスクのステータスと結果をクエリします。

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

その他のエンドポイント

エンドポイント	メソッド	説明
`/suno/lyrics`	POST	歌詞を生成
`/suno/upload`	POST	外部オーディオファイルをアップロード
`/suno/persona`	GET/POST	ボイスペルソナを管理
`/suno/wav`	POST	WAV形式でエクスポート

完全な API リファレンスについては英語または中国語のドキュメントを参照してください。

よくある質問

Q: どのモデルを使うべきですか？
chirp-v5-5 を使用してください（最新かつ最も高性能）。

Q: 生成にどのくらい時間がかかりますか？
generate は通常 15-40秒です。

Q: audio_url は直接使用できますか？
はい、CDN の直接リンクで再生またはダウンロードできます。