API remaster (Remaster)

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

Mô tả endpoint

Remaster tạo lại một bài hát đã hoàn tất thành «bản remaster» có chất lượng âm thanh tốt hơn. Trả về 2 phiên bản cùng lúc và hệ thống thượng nguồn tự động thêm (Remastered) vào tiêu đề.

Endpoint: POST /api/music/remaster

Tính phí: Có phí, tính theo mô hình được yêu cầu (mặc định suno-v6, 0,6 CNY mỗi lần gọi); số tiền thực trừ tuân theo cấu hình giá trong phần quản trị.

Về mô hình: remaster dùng một endpoint thượng nguồn riêng và một mô hình remaster riêng, do nền tảng cố định và không thay đổi theo model; model trong yêu cầu chỉ dùng cho giá và chọn kênh, nên truyền suno-v6 rõ ràng.

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 remaster khi phản hồi trả về. 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 remaster, 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.

Xác thực

Tham số yêu cầu

audio_id, source_clip_id và sourceClipId là cách viết tương đương của song_id; dùng một trong số đó.

Ví dụ yêu cầu

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

Nếu các giá trị mặc định là đủ, chỉ cần gửi bài hát nguồn — tương đương variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Tiêu đề bài hát nguồn (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Tiêu đề bài hát nguồn (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Một lần gọi trả về 2 phiên bản remaster. Lưu cả hai clips[].song_id rồi dùng API truy vấn bài hát và lịch sử để hỏi đến complete trước khi lấy âm thanh.

Lưu ý

• Bài hát nguồn phải đã hoàn tất và nằm trong phạm vi truy cập của khóa API hiện tại; tư liệu nguồn bên ngoài sẽ được đồng bộ tự động về tài khoản thực thi.
• Remaster chỉ làm lại chất lượng âm thanh: muốn đổi phong cách, phối khí hay giọng hát, hãy dùng tăng cường phong cách, tải lên rồi cover hoặc các endpoint Remix.
• variation_category càng lớn thì bản remaster càng khác bài hát nguồn; trước khi giao chính thức, hãy thử normal trước rồi tăng lên.