API remaster (Remaster)

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Remaster menjana semula lagu yang sudah selesai sebagai "versi remaster" dengan kualiti audio lebih baik. Ia memulangkan 2 versi sekali gus, dan pihak huluan menambah (Remastered) pada tajuk secara automatik.

Endpoint: POST /api/music/remaster

Pengebilan: Berbayar, dibilkan mengikut model yang diminta (lalai suno-v6, 0.6 CNY setiap panggilan); jumlah yang benar-benar dicaj mengikut tetapan harga dalam back-office.

Mengenai model: remaster menggunakan endpoint huluan khusus dan model remaster khusus, ditetapkan oleh platform dan tidak berubah mengikut model; model dalam permintaan hanya digunakan untuk harga dan pemilihan saluran, jadi disyorkan menghantar suno-v6 secara eksplisit.

Masa menunggu dan timeout (penting): ini endpoint segerak — pesanan hanya diterima dan dihantar ke remaster apabila respons tiba. Tetapkan timeout klien kepada 300 saat atau lebih; tiada respons tidak bermakna tiada apa-apa diremaster, dan jangan cuba semula sejurus selepas timeout (ia menggandakan pesanan dan mencaj dua kali). Jika sambungan terputus, periksa kemudian dengan GET /api/music/songs.

Pengesahan

Parameter permintaan

audio_id, source_clip_id dan sourceClipId ialah ejaan setara bagi song_id; gunakan salah satu.

Contoh permintaan

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"
  }'

Jika nilai lalai sudah memadai, hantar hanya lagu sumber — sama seperti variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Tajuk lagu sumber (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Tajuk lagu sumber (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Satu panggilan memulangkan 2 versi remaster. Simpan kedua-dua clips[].song_id kemudian tinjau API pertanyaan lagu dan sejarah sehingga complete sebelum mengambil audio.

Nota

• Lagu sumber mesti sudah selesai dan berada dalam skop akses kunci API semasa; bahan sumber luaran disegerakkan secara automatik ke akaun pelaksana.
• Remaster hanya membuat semula kualiti audio: untuk menukar gaya, susunan atau vokal, gunakan pengukuhan gaya, muat naik lalu cover atau endpoint Remix.
• Semakin besar variation_category, semakin berbeza versi remaster daripada lagu sumber; sebelum penghantaran sebenar, cuba normal dahulu kemudian tingkatkan.