API pobierania Free2

Zaktualizowano 2026-09-18 · zespół Suno-API

Opis punktu końcowego

Free2 to osobny płatny kanał pobierania: rozwiązuje pliki MP3/WAV/tekstu/metadanych na podstawie identyfikatora utworu (lub linku do utworu suno.com) i zwraca hostowane przez platformę adresy pobierania. Przyjmuje wyłącznie klucz API — nie przyjmuje sesji przeglądarki — a odpowiedź nigdy nie zawiera zaszyfrowanego źródła odtwarzania Suno.

Punkt końcowy: POST /api/music/free2

Rozliczenie: opłata za udany utwór, obecnie domyślnie 0,2 CNY za utwór. Wybór kilku typów plików w jednym żądaniu nie podnosi ceny; utwory, których nie udało się rozwiązać, nie są rozliczane. Maksymalnie 10 utworów na żądanie (po odduplikowaniu); faktycznie pobrana kwota zależy od konfiguracji cen w panelu administracyjnym.

Zalecany model: suno-v6. Dostępne są suno-v6, suno-v6-wild i suno-v6-mini.

Uwierzytelnianie

Parametry żądania

Podaj co najmniej jeden z song_id i song_ids; podaj co najmniej jeden element w files.

Przykład żądania

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

Odpowiedź

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

Gdy żądany jest tylko jeden utwór, odpowiedź zawiera dodatkowo song_id i files na najwyższym poziomie, dla zgodności ze starym wariantem pojedynczego utworu.

Ponowne użycie adresów z pamięci podręcznej (bez opłat)

Dla utworu, który już pobrano, ponowne pobranie nie wymaga nowego rozwiązywania i nie jest ponownie rozliczane: użyj POST /api/music/free2/cached, aby otrzymać aktualne adresy plików pobranych wcześniej przez to konto.

Punkt końcowy: POST /api/music/free2/cached

Rozliczenie: Bezpłatne. To pamięć podręczna tylko do odczytu: bez rozwiązywania, bez transkodowania, bez opłat; zwracane są wyłącznie adresy już przygotowane i nieodzyskane.

⚠️ Ważność adresu pobierania: 7 dni — zapisz go na czas. songs[].files[].url udostępnia magazyn obiektów platformy i domyślnie wygasa po 7 dniach (pliki są odzyskiwane, a stary adres zwraca 404); zapisz je we własnym magazynie w ciągu tych 7 dni. Po wygaśnięciu wywołaj ponownie POST /api/music/free2, aby przygotować je od nowa i uzyskać ważny adres (to ponowne przygotowanie jest rozliczane według normalnych zasad; /api/music/free2/cached zwraca tylko nadal ważne adresy z pamięci podręcznej).

Parametry żądania: identyczne jak w POST /api/music/free2 (dowolny z song_id / song_ids / songs oraz co najmniej jeden element w 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-…"]
  }
}

Adresy są zwracane tylko dla utworów, które już pobrano; utwory bez historii pobrań lub z już odzyskanymi zasobami pojawiają się wyłącznie w missing i nie zwracają żadnego adresu.

Uwagi

• POST /api/music/free2 potrafi rozwiązać dowolny publiczny utwór w Suno (także utwory spoza tej platformy); gdy utworu nie da się rozwiązać, error zwracany jest tylko dla niego i nie wpływa na pozostałe utwory w tej samej partii. Natomiast POST /api/music/free2/cached zwraca adresy tylko dla utworów pobranych przez to konto.
• Pierwsze rozwiązanie utworu tworzy hostowane pliki, które potem są ponownie używane; nie podawaj powtórzonych typów w files, serwer usuwa duplikaty automatycznie.
• Różnica względem API pobierania i odsłuchu mediów utworów: Free2 jest płatne, przyjmuje bezpośrednio linki suno.com i poza tekstem nie udostępnia takich typów jak os czasu/MIDI.