マスタリング（Remaster）API
インターフェースの説明
マスタリングは、完成済みの楽曲から音質を高めた「リマスター版」を再生成します。1 回で 2 つのバージョンを返し、タイトルには上流が自動的に (Remastered) を追加します。
エンドポイント: POST /api/music/remaster
課金: 有料。要求したモデルに応じて課金され（既定は suno-v6、0.6 元/回）、実際の請求額は管理画面の価格設定に従います。
モデルの説明: リマスターは上流の専用インターフェースと専用モデルを使い、プラットフォーム側で固定されるため model によって変わりません。リクエストの model は価格計算とチャネル選択にのみ使われ、suno-v6 を明示的に渡すことをおすすめします。
待ち時間とタイムアウト（重要）: 本エンドポイントは同期インターフェースで、レスポンスが返った時点で初めて注文が受理されリマスターに投入されます。クライアントのタイムアウトは 300 秒以上に設定してください。レスポンスが無いことは未処理を意味せず、タイムアウト直後の再試行は注文の重複と二重課金につながります。接続が切れた場合は少し後に
GET /api/music/songsで確認できます。
認証
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| Authorization | string | はい | Bearer YOUR_API_KEY |
| Content-Type | string | はい | application/json |
リクエストパラメータ
| パラメータ名 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| song_id | string | はい | - | リマスターするソース楽曲 ID。完了済みで、現在の API Key から参照できる必要があります |
| model | string | いいえ | suno-v6 | 対客モデル名: suno-v6、suno-v6-wild、suno-v6-mini。価格とチャネルのみに使用 |
| variation_category | string | いいえ | normal | 変体の強さ: subtle、normal、high（旧値 low は subtle と同じ） |
| style_profile | string | いいえ | boost | 音色スタイル: natural、boost、clarity |
| tags | string | いいえ | - | 予約フィールド。空でなければ上流にそのまま渡されます |
| source_audio_url | string | いいえ | - | ソース楽曲が外部アカウント由来の場合のソース音声アドレス |
| source_file_name | string | いいえ | - | ソース楽曲が外部アカウント由来の場合のソースファイル名 |
| source_title | string | いいえ | - | ソース楽曲が外部アカウント由来の場合のソースタイトル |
audio_id、source_clip_id、sourceClipId は song_id と等価な書き方で、いずれか 1 つを使えば十分です。
リクエスト例
curl -X POST https://www.suno-api.io/api/music/remaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "source_song_id",
"variation_category": "high",
"style_profile": "clarity"
}'
既定の設定でよければソース楽曲だけを渡します。これは variation_category: normal + style_profile: boost と同じです:
{ "model": "suno-v6", "song_id": "source_song_id" }
レスポンス結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "元の曲名 (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "元の曲名 (Remastered)",
"status": "processing"
}
]
}
}
1 回で 2 つのリマスター版が返ります。clips[].song_id を 2 つとも保存し、楽曲照会 API で complete になるまでポーリングしてから音声を取得してください。
注意事項
- ソース楽曲は完了済みで、現在の API Key から参照できる範囲にある必要があります。外部由来の素材は実行アカウントへ自動的に同期されます。
- リマスターは音質の作り直しのみです。スタイル・編曲・歌唱を変えたい場合はスタイル強化、アップロード後カバー、または Remix 系インターフェースをご利用ください。
variation_categoryが大きいほど、リマスター版とソース楽曲の差が大きくなります。正式納品の前にnormalで試してから上げることをおすすめします。