トリミング API
インターフェースの説明
トリミングは、既存の楽曲の指定した時間帯を残し、切り出した新しいバージョンを生成します。
エンドポイント: POST /api/music/crop
課金: 有料。要求したモデルに応じて課金され、実際の請求額は管理画面の価格設定に従います。
推奨モデル: suno-v6。suno-v6、suno-v6-wild、suno-v6-mini が利用できます。
待ち時間とタイムアウト（重要）: 本エンドポイントは同期インターフェースで、レスポンスが返った時点で初めて注文が受理され生成に投入されます。実測では多くのリクエストが 1〜3 秒で返り、約 10% が 30 秒を超え、最長は約 230 秒です。クライアントのタイムアウトは 300 秒以上に設定してください。レスポンスが無いことは未生成を意味せず、タイムアウト直後の再試行は注文の重複と二重課金につながります。 接続が切れた場合は少し後に
GET /api/music/songsで確認できます。詳しくは新版 API 概要の「待ち時間とタイムアウト設定」をご覧ください。
認証
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| Authorization | string | はい | Bearer YOUR_API_KEY |
| Content-Type | string | はい | application/json |
リクエストパラメータ
| パラメータ名 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| model | string | はい | - | 対客モデル名: suno-v6、suno-v6-wild、suno-v6-mini |
| source_clip_id | string | はい | - | ソース楽曲の実際の song_id。完了済みで、現在の API Key から参照できる必要があります |
| crop_start_s | number | はい | - | 残す区間の開始秒。0 以上である必要があります |
| crop_end_s | number | はい | - | 残す区間の終了秒。crop_start_s より大きい必要があります |
| song_title | string | いいえ | - | 結果のタイトル |
リクエスト例
curl -X POST https://www.suno-api.io/api/music/crop \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 10,
"crop_end_s": 48,
"song_title": "トリミング版"
}'
レスポンス結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "トリミング版",
"status": "processing"
}
]
}
}
1 回の呼び出しで 1 件だけ返ります（編集系の操作は 2 曲出しません）。clips[].song_id を保存し、楽曲照会 API で completed になるまでポーリングしてください。最初のレスポンスで照会可能な song_id がまだ登録されていないことがありますが、少し待ってから再度照会すれば問題ありません。
注意事項
- 残す区間は
0 <= crop_start_s < crop_end_sを満たし、かつソース楽曲の長さ内である必要があります。 - トリミングとは異なり、区間を削除したい場合は削除 API を使ってください。