API tăng cường phong cách

Cập nhật 2026-09-18 · nhóm Suno-API

Mô tả endpoint

Tăng cường phong cách mở rộng một thẻ phong cách ngắn thành mô tả phong cách đầy đủ hơn, phù hợp hơn với việc tạo nhạc của Suno, và cũng có thể tạo đoạn mô tả phong cách từ lời bài hát đầy đủ.

Endpoint: POST /api/music/boost-style

Tính phí: Miễn phí trong hạn mức (tối đa 10 lần mỗi phút và 300 lần mỗi ngày cho mỗi người dùng); vượt hạn mức miễn phí thì 0,1 ¥ mỗi lần gọi.

Nhận biết vượt hạn mức: khi vượt hạn mức miễn phí, yêu cầu vẫn chạy bình thường và header phản hồi có X-Suno-Helper-Free: false cùng X-Suno-Helper-Over-Limit: minute (hoặc day), nhờ đó client có thể báo rằng lần gọi này đã bị tính phí.

Mô hình khuyến nghị: suno-v6. Có thể dùng suno-v6, suno-v6-wild hoặc suno-v6-mini.

Đầu ra tiếng Trung: khi nội dung yêu cầu (originalTags/lyrics/user_guidance) có tiếng Trung và chưa khai báo ngôn ngữ, hệ thống tự động thêm （请用中文描述） sau original_tags và bổ sung user_guidance=语言：简体中文；乐器名也用中文, nhằm tăng tỉ lệ ra mô tả phong cách bằng tiếng Trung. Giá trị thực sự được gửi sẽ trả về trong appliedOriginalTags và appliedUserGuidance của phản hồi. Nếu nội dung bạn gửi đã ghi rõ ngôn ngữ (ví dụ "mô tả bằng tiếng Trung giản thể"), hệ thống sẽ không sửa gì.

Xác thực

Tham số yêu cầu

Ví dụ yêu cầu

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]\nĐêm buông ngoài cửa sổ\n[Chorus]\nTa bước về phía ánh sáng",
    "user_guidance": "thêm suona và erhu, giọng nam, tiết tấu nhanh hơn",
    "instrumental": false
  }'

Phản hồi

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

upsampledStyle là mô tả phong cách đầy đủ cần ghi lại vào ô Style.