API tạo hiệu ứng âm thanh

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

Mô tả endpoint

Tạo hiệu ứng âm thanh tạo ra vài giây âm thanh, không phải một bài hát. Phù hợp với âm thanh ngắn như sấm, giọt mưa hay tiếng va chạm, và cũng dùng được cho hiệu ứng chuyển cảnh, âm thanh nền và vòng lặp trống; phần lớn dưới 5 giây, dài nhất khoảng 20 giây. Hỗ trợ hai chế độ một lần và lặp.

Endpoint: POST /api/music/sounds

Tính phí: Có phí, hiện mặc định 0,6 CNY mỗi lần gọi. Số tiền thực trừ tuân theo cấu hình giá hiện tại trong phần quản trị.

Thời gian chờ và timeout (quan trọng): đây là endpoint đồng bộ — đơn chỉ được tiếp nhận và đưa vào tạo nhạc khi phản hồi trả về. Theo đo đạc, phần lớn yêu cầu trả về trong 1-3 giây, khoảng 10% mất hơn 30 giây và lâu nhất khoảng 230 giây. Hãy đặt timeout phía client từ 300 giây trở lên; không nhận được phản hồi không có nghĩa là chưa tạo gì, và đừng thử lại ngay sau khi timeout (sẽ trùng đơn và bị tính phí hai lần). Nếu kết nối bị ngắt, hãy kiểm tra lại sau bằng GET /api/music/songs. Xem "Thời gian chờ và thiết lập timeout" trong Tổng quan API mới.

Tham số yêu cầu

Headers

Tham số body

Ví dụ yêu cầu

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Phản hồi

Trả về mảng bài hát; các trường giống với trường trả về bài hát chung trong Tổng quan API mới.