API pengukuhan gaya

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

Penerangan endpoint

Pengukuhan gaya mengembangkan tag gaya pendek menjadi penerangan gaya yang lebih lengkap dan lebih sesuai untuk penjanaan Suno, dan juga boleh menjana perenggan gaya daripada lirik yang lengkap.

Endpoint: POST /api/music/boost-style

Pengebilan: Percuma dalam kuota (maksimum 10 panggilan seminit dan 300 sehari bagi setiap pengguna); melebihi kuota percuma dikenakan 0.1 ¥ setiap panggilan.

Mengesan melebihi had: apabila kuota percuma dilangkaui, permintaan tetap berjalan seperti biasa, dan pengepala respons membawa X-Suno-Helper-Free: false serta X-Suno-Helper-Over-Limit: minute (atau day), jadi klien boleh memberitahu bahawa panggilan ini telah dibilkan.

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

Output bahasa Cina: apabila kandungan permintaan (originalTags/lyrics/user_guidance) mengandungi bahasa Cina dan bahasa tidak dinyatakan, perkhidmatan menambah （请用中文描述） selepas original_tags secara automatik dan melengkapkan user_guidance=语言：简体中文；乐器名也用中文, untuk meningkatkan kadar penerangan gaya dalam bahasa Cina. Nilai yang benar-benar dihantar dikembalikan dalam appliedOriginalTags dan appliedUserGuidance pada respons. Jika kandungan yang anda hantar sudah menyatakan bahasa (contohnya "jelaskan dalam bahasa Cina ringkas"), perkhidmatan tidak mengubah apa-apa.

Pengesahan

Parameter permintaan

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 turun di luar tingkap\n[Chorus]\nKita melangkah ke arah cahaya",
    "user_guidance": "tambah suona dan erhu, vokal lelaki, tempo lebih pantas",
    "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 ialah penerangan gaya lengkap yang perlu ditulis semula ke dalam medan Style.