API tải xuống Free2

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

Mô tả endpoint

Free2 là một kênh tải xuống trả phí riêng: nó phân giải tệp MP3/WAV/lời/nhạc nền từ ID bài hát (hoặc link bài hát suno.com) và trả về địa chỉ tải xuống do nền tảng lưu trữ. Nó chỉ nhận khóa API — không nhận phiên đăng nhập trình duyệt — và phản hồi không bao giờ chứa nguồn phát đã mã hóa của Suno.

Endpoint: POST /api/music/free2

Tính phí: tính theo bài phân giải thành công, hiện mặc định 0,2 CNY mỗi bài. Chọn nhiều loại tệp trong cùng một yêu cầu không tính thêm phí; những bài không phân giải được sẽ không bị tính phí. Tối đa 10 bài mỗi yêu cầu (sau khi loại trùng); số tiền thực trừ tuân theo cấu hình giá trong phần quản trị.

Mô hình đề xuất: suno-v6. Có thể dùng suno-v6, suno-v6-wild hoặc suno-v6-mini.

Xác thực

Tham số yêu cầu

Truyền ít nhất một trong song_id và song_ids; truyền ít nhất một phần tử trong files.

Ví dụ yêu cầu

curl -X POST https://www.suno-api.io/api/music/free2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["song_id_1", "song_id_2"],
    "files": ["mp3", "wav", "lyrics"]
  }'

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "songs": [
      {
        "song_id": "song_id_1",
        "files": [
          {"type": "mp3", "url": "https://media.suno-api.io/assets/song_id_1-free2-v1-mp3.mp3"}
        ]
      },
      {
        "song_id": "song_id_2",
        "files": [],
        "error": {"code": "song_not_found", "message": "song not found or not owned by the current user"}
      }
    ],
    "requested_songs": 2,
    "succeeded_songs": 1,
    "price": 0.2
  }
}

Khi chỉ yêu cầu một bài, phản hồi còn trả thêm song_id và files ở cấp cao nhất, để tương thích với dạng một bài cũ.

Dùng lại địa chỉ trong bộ nhớ đệm (không tính phí)

Với bài đã tải trước đó, lần tải lại không cần phân giải mới và không bị tính phí lần nữa: dùng POST /api/music/free2/cached để lấy địa chỉ hiện tại của những tệp mà tài khoản này đã tải trước đây.

Endpoint: POST /api/music/free2/cached

Tính phí: Miễn phí. Đây là bộ nhớ đệm chỉ đọc: không phân giải, không chuyển mã, không tính phí; chỉ trả về những địa chỉ đã sẵn sàng và chưa bị thu hồi.

⚠️ Thời hạn của địa chỉ tải xuống: 7 ngày — hãy lưu trữ kịp thời. songs[].files[].url 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 chúng vào kho của bạn trong 7 ngày đó. Sau khi hết hạn, gọi lại POST /api/music/free2 để chuẩn bị lại và nhận địa chỉ hợp lệ mới (lần chuẩn bị lại đó được tính phí theo quy tắc thông thường; /api/music/free2/cached chỉ trả về địa chỉ trong bộ nhớ đệm còn hiệu lực).

Tham số yêu cầu: giống hệt POST /api/music/free2 (một trong song_id / song_ids / songs, và ít nhất một phần tử trong files).

curl -X POST https://www.suno-api.io/api/music/free2/cached \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "song_ids": ["98ca3f1d-…", "a185b3d9-…"], "files": ["mp3"] }'

{
  "success": true,
  "data": {
    "items": [
      { "song_id": "98ca3f1d-…", "type": "mp3", "url": "https://…/assets/98ca3f1d-…-free2-v1-mp3.mp3" }
    ],
    "songs": [
      { "song_id": "98ca3f1d-…", "files": [ { "type": "mp3", "url": "https://…" } ], "missing_files": [] },
      { "song_id": "a185b3d9-…", "files": [], "missing_files": ["mp3"] }
    ],
    "missing": ["a185b3d9-…"]
  }
}

Địa chỉ chỉ được trả về cho những bài bạn đã tải trước đây; bài không có lịch sử tải, hoặc tài nguyên đã bị thu hồi, chỉ xuất hiện trong missing và không trả về địa chỉ nào.

Lưu ý

• POST /api/music/free2 có thể phân giải bất kỳ bài công khai nào trên Suno (kể cả bài không có trên nền tảng này); khi không phân giải được, error chỉ trả cho bài đó và không ảnh hưởng các bài khác trong cùng lô. Ngược lại, POST /api/music/free2/cached chỉ trả địa chỉ cho những bài mà tài khoản này đã tải.
• Lần phân giải đầu tiên của một bài sẽ tạo các tệp lưu trữ, sau đó được dùng lại; đừng truyền loại trùng trong files, máy chủ sẽ tự loại trùng.
• Khác với API tải và nghe thử media của bài hát: Free2 là bản trả phí, nhận link suno.com trực tiếp và ngoài lời ra không cung cấp các loại như dòng thời gian/MIDI.