倒放 API

2026-09-18 更新 · Suno-API 團隊

介面說明

倒放用於把既有歌曲反向播放並生成新的版本。

介面位址：POST /api/music/reverse

計費：收費，依請求模型計費，實際扣費以後台價格設定為準。

推薦模型：suno-v6。可用 suno-v6、suno-v6-wild 或 suno-v6-mini。

等待時間與逾時（重要）：本介面是同步介面，回應返回時才代表訂單已被受理並提交生成。實測多數請求 1–3 秒返回，約 10% 超過 30 秒，最長約 230 秒。請把用戶端逾時設為 300 秒以上；未收到回應不等於沒有生成，逾時後請勿立即重試（會重複下單、重複扣費）。 連線中斷可稍後用 GET /api/music/songs 確認。詳見 Suno API 介面文件總覽的「等待時間與逾時設定」。

驗證

請求參數

請求範例

curl -X POST https://www.suno-api.io/api/music/reverse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "倒放版本"
  }'

回應結果

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "倒放版本",
        "status": "processing"
      }
    ]
  }
}

一次回傳 1 條結果（編輯類動作不是一次出 2 首）。請保存 clips[].song_id，再使用歌曲查詢 API輪詢到 completed。

注意事項

• source_clip_id 必須是真實、已完成且目前 API Key 可存取的歌曲 ID。
• 結果時長通常與來源歌曲一致。