API tạo/lấy WAV

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

Mô tả endpoint

Endpoint WAV tạo hoặc lấy địa chỉ âm thanh WAV không mất dữ liệu của một bài hát đã có.

Endpoint: POST /api/music/wav

Tính phí: Miễn phí. Endpoint này tạo hoặc lấy địa chỉ WAV của bài hát đã có và không trừ hạn mức.

Thời gian chờ và timeout (quan trọng): đây là endpoint đồng bộ — đơn chỉ được tiếp nhận 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. 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

maxAttempts và intervalSeconds đều là số JSON; intervalSeconds tính bằng giây, không phải mili-giây, và thường chỉ cần giữ giá trị mặc định. Chúng chỉ điều khiển số lần và khoảng cách mà endpoint này chờ WAV sẵn sàng ở bên trong; không làm thay đổi trạng thái của chính tác vụ tạo nhạc.

Ví dụ yêu cầu

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Lưu ý

Việc tạo và tra cứu WAV do máy chủ tự chọn tài nguyên khả dụng dựa trên bản ghi bài hát; khách hàng không cần cung cấp thông tin tài khoản nào.

Bài hát thường và track đã tách dùng cùng một đường phân phối media có kiểm soát. WAV được CN2 tải về và ghi ra đĩa trước, và data.wavUrl trong phản hồi thành công chỉ trả về địa chỉ CDN có kiểm soát — không bao giờ trả về địa chỉ nguồn tạm thời của Suno hay S3.

Nếu đã có tài nguyên WAV ở trạng thái ready thì dùng lại luôn, không yêu cầu lại Suno và không di chuyển tệp lần nữa. WAV chưa được chuẩn bị sẽ không bị lộ thành địa chỉ Suno/S3 qua /api/music/query; chỉ được chuẩn bị theo nhu cầu sau khi gọi endpoint này hoặc endpoint tải xuống thống nhất.

⚠️ Thời hạn của địa chỉ WAV: 7 ngày — hãy lưu trữ kịp thời. data.wavUrl trả về do kho đối tượng của nền tảng cung cấp và mặc định hết hiệu lực sau 7 ngày (tệp bị thu hồi và địa chỉ cũ trả về 404). Hãy lưu WAV vào kho của bạn trong thời hạn đó; sau khi hết hạn, gọi lại endpoint này để nhận địa chỉ hợp lệ mới.

Nếu tài nguyên bài hát tạm thời không khả dụng, endpoint trả về 409. Hãy thử lại sau; máy chủ sẽ không trả về địa chỉ tạm thời không ổn định.