API penguatan gaya

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Penguatan gaya memperluas tag gaya pendek menjadi deskripsi gaya yang lebih lengkap dan lebih cocok untuk pembuatan di Suno, dan juga dapat menghasilkan bagian deskripsi gaya dari lirik yang lengkap.

Endpoint: POST /api/music/boost-style

Biaya: Gratis dalam kuota (maksimal 10 panggilan per menit dan 300 per hari per pengguna); di luar kuota gratis dikenai 0,1 ¥ per panggilan.

Mendeteksi kelebihan: ketika kuota gratis terlampaui, permintaan tetap berjalan normal, dan header respons membawa X-Suno-Helper-Free: false serta X-Suno-Helper-Over-Limit: minute (atau day), sehingga klien dapat memberi tahu bahwa panggilan ini dikenai biaya.

Model yang disarankan: suno-v6. Tersedia suno-v6, suno-v6-wild, dan suno-v6-mini.

Keluaran bahasa Mandarin: bila isi permintaan (originalTags/lyrics/user_guidance) mengandung bahasa Mandarin dan bahasa tidak dinyatakan, layanan otomatis menambahkan （请用中文描述） setelah original_tags dan melengkapi user_guidance=语言：简体中文；乐器名也用中文, untuk meningkatkan peluang deskripsi gaya berbahasa Mandarin. Nilai yang benar-benar dikirim dikembalikan pada appliedOriginalTags dan appliedUserGuidance di respons. Jika isi yang Anda kirim sudah menyatakan bahasa (misalnya "jelaskan dalam bahasa Mandarin sederhana"), layanan tidak mengubah apa pun.

Autentikasi

Parameter	Tipe	Wajib	Catatan
Authorization	string	ya	`Bearer YOUR_API_KEY`
Content-Type	string	ya	`application/json`

Parameter permintaan

Parameter	Tipe	Wajib	Default	Catatan
model	string	ya	-	Nama model untuk pelanggan: `suno-v6`, `suno-v6-wild`, atau `suno-v6-mini`
originalTags	string	tidak	-	Tag gaya asli
original_tags	string	tidak	-	Alias kompatibel `originalTags`
style	string	tidak	-	Tag gaya asli; pilih salah satu dengan `originalTags`
instrumental	boolean	tidak	false	Apakah menguatkan ke arah instrumental
lyrics	string	tidak	-	Lirik lengkap; bila dikirim, deskripsi gaya dibuat dari isinya
user_guidance	string	tidak	-	Permintaan pengguna dalam bahasa alami, misalnya "tambahkan suona dan erhu, vokal pria, tempo lebih cepat"; platform punya kolom dengan nama sama dan meneruskannya apa adanya

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nMalam jatuh di luar jendela\n[Chorus]\nKita berjalan menuju cahaya",
    "user_guidance": "tambahkan suona dan erhu, vokal pria, tempo lebih cepat",
    "instrumental": false
  }'

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle adalah deskripsi gaya lengkap yang harus ditulis kembali ke kolom Style.

BerikutnyaAPI saran prompt

Dapatkan kunci API

Buat kunci API di konsol setelah mendaftar. Setiap pembuatan berbiaya 0,6 ¥ dan menghasilkan 2 lagu, unduhan tidak terbatas, dan nomor telepon tidak diperlukan.

Ambil kunci API Kembali ke ringkasan