Free2-nedladdnings-API

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Free2 är en egen betald nedladdningskanal: den löser upp MP3/WAV/låttext/metadata-filer utifrån ett låt-ID (eller en suno.com-låt länk) och returnerar nedladdningsadresser som plattformen hostingar. Den accepterar endast en API-nyckel — inte en inloggningssession i webbläsaren — och svaret innehåller aldrig Sunos krypterade uppspelningskälla.

Ändpunkt: POST /api/music/free2

Fakturering: debiteras per framgångsrikt upplöst låt, för närvarande 0,2 CNY per låt som standard. Att välja flera filtyper i en begäran kostar inget extra; låtar som inte kan lösas upp debiteras inte. Högst 10 låtar per begäran (efter dublettrensning); det faktiskt debiterade beloppet följer prisinställningen i backoffice.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

Autentisering

Begäransparametrar

Ange minst en av song_id och song_ids; ange minst ett element i files.

Exempelbegäran

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

Svar

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

När bara en låt begärs innehåller svaret även song_id och files på översta nivån, för kompatibilitet med den äldre formen för en enskild låt.

Återanvända cachade adresser (kostnadsfritt)

För en låt du redan har laddat ner krävs ingen ny upplösning och ingen ny debitering: använd POST /api/music/free2/cached för att hämta de aktuella adresserna för de filer som kontot laddade ner tidigare.

Ändpunkt: POST /api/music/free2/cached

Fakturering: Kostnadsfritt. Det är en skrivskyddad cache: ingen upplösning, ingen omkodning, ingen debitering; endast adresser som redan är förberedda och inte återkallade returneras.

⚠️ Nedladdningsadressens giltighet: 7 dagar — spara i tid. songs[].files[].url tillhandahålls av plattformens objektlagring och upphör som standard efter 7 dagar (filerna återkallas och den gamla adressen ger 404); spara dem i din egen lagring inom dessa 7 dagar. När en adress har gått ut anropar du POST /api/music/free2 igen för att förbereda den på nytt och få en giltig adress (den nya förberedelsen debiteras enligt normala regler; /api/music/free2/cached returnerar bara cache-adresser som fortfarande är giltiga).

Begäransparametrar: identiska med POST /api/music/free2 (någon av song_id / song_ids / songs, och minst ett element i 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-…"]
  }
}

Adresser returneras bara för låtar du har laddat ner tidigare; låtar utan nedladdningshistorik, eller vars tillgångar redan återkallats, visas bara i missing och får ingen adress.

Noter

• POST /api/music/free2 kan lösa upp vilken offentlig låt som helst på Suno (även låtar som inte finns på den här plattformen); går en låt inte att lösa upp returneras ett error bara för den låten och övriga låtar i samma batch påverkas inte. POST /api/music/free2/cached returnerar däremot adresser bara för låtar som detta konto har laddat ner.
• Den första upplösningen av en låt skapar de hostade filerna, som sedan återanvänds; skicka inte dubblerade typer i files, servern rensar dubletter automatiskt.
• Skillnad mot API för nedladdning och uppspelning av låtmedia: Free2 är betalt, accepterar suno.com-länkar direkt och erbjuder, utöver text, inte typer som tidslinje/MIDI.