API muat turun Free2

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Free2 ialah saluran muat turun berbayar yang berasingan: ia menyelesaikan fail MP3/WAV/lirik/metadata daripada ID lagu (atau pautan lagu suno.com) dan memulangkan alamat muat turun yang dihoskan oleh platform. Ia menerima kunci API sahaja, tidak menerima sesi log masuk pelayar, dan responsnya tidak pernah mengandungi sumber main balik Suno yang disulitkan.

Endpoint: POST /api/music/free2

Pengebilan: Dicaj mengikut bilangan lagu yang berjaya, kini lalai 0.2 CNY setiap lagu. Memilih beberapa jenis fail dalam satu permintaan tidak menambah kos; lagu yang gagal diselesaikan tidak dikenakan caj. Maksimum 10 lagu bagi setiap permintaan (selepas nyahduplikasi); jumlah yang sebenarnya dicaj mengikut konfigurasi harga di back-office.

Model yang disyorkan: suno-v6. suno-v6, suno-v6-wild dan suno-v6-mini tersedia.

Pengesahan

Parameter permintaan

Berikan sekurang-kurangnya salah satu daripada song_id atau song_ids; sertakan sekurang-kurangnya satu nilai dalam files.

Contoh permintaan

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"]
  }'

Respons

{
  "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
  }
}

Apabila hanya satu lagu diminta, respons turut memulangkan song_id dan files pada aras atas, untuk keserasian dengan bentuk satu lagu yang lama.

Guna semula alamat cache (tanpa kos)

Bagi lagu yang pernah anda muat turun, memuat turunnya semula tidak memerlukan penyelesaian baharu dan tidak dikenakan caj lagi: gunakan POST /api/music/free2/cached untuk mendapatkan alamat semasa bagi fail yang pernah dimuat turun oleh akaun ini.

Endpoint: POST /api/music/free2/cached

Pengebilan: Percuma. Ia cache baca sahaja: tiada penyelesaian, tiada transkod, tiada caj; hanya memulangkan alamat yang sudah sedia dan belum diambil semula.

⚠️ Tempoh sah alamat muat turun: 7 hari — simpan segera. songs[].files[].url disediakan oleh storan objek platform dan tamat secara lalai selepas 7 hari (fail diambil semula dan alamat lama memulangkan 404); simpan fail itu ke storan anda sendiri dalam tempoh 7 hari itu. Selepas tamat tempoh, panggil semula POST /api/music/free2 untuk menyediakannya semula dan mendapatkan alamat sah yang baharu (penyediaan semula itu dicaj mengikut peraturan biasa; /api/music/free2/cached hanya memulangkan alamat cache yang masih sah).

Parameter permintaan: sama seperti POST /api/music/free2 (mana-mana satu daripada song_id / song_ids / songs, dan sekurang-kurangnya satu nilai dalam 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-…"]
  }
}

Alamat hanya dipulangkan bagi lagu yang pernah anda muat turun; lagu tanpa rekod muat turun, atau yang asetnya sudah diambil semula, hanya muncul dalam missing dan tiada alamat dipulangkan untuknya.

Nota

• POST /api/music/free2 boleh menyelesaikan mana-mana lagu awam di Suno (termasuk lagu yang tidak ada pada platform ini); apabila sesuatu lagu gagal diselesaikan, error dipulangkan untuk lagu itu sahaja dan lagu lain dalam kelompok yang sama tidak terjejas. Manakala POST /api/music/free2/cached hanya memulangkan alamat bagi lagu yang pernah dimuat turun oleh akaun ini.
• Penyelesaian pertama sesuatu lagu akan menghasilkan fail yang dihoskan, dan selepas itu fail tersebut diguna semula; jangan hantar jenis yang sama berulang dalam files, pelayan akan menyahduplikasinya secara automatik.
• Perbezaan daripada API muat turun dan pratonton media lagu: Free2 berbayar, menyokong penghantaran pautan suno.com secara terus, dan tidak menyediakan jenis garis masa/MIDI selain lirik.