Översikt över Suno API-dokumentationen

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

Det räcker att registrera sig med e-post för att skapa en API-nyckel. En generering kostar 0,6 ¥ och returnerar 2 låtar, med MP3/WAV-nedladdning, covers, Extend, stems-separation och röstkloning. Bas-URL: https://www.suno-api.io.

Den här sidan beskriver tillgängliga modeller, alla genererings- och redigeringsändpunkter, fakturering och rekommenderad läsordning. Vid en första integration: läs uppifrån och ned; ingångarna för 401/403/429 finns också här.

Snabba svar

Hur får jag en API-nyckel? Registrera dig med e-post, öppna konsolen, gå till tokenhantering och skapa en token. Telefonnummer och kort behövs inte.

Vad kostar ett anrop? En generering kostar 0,6 ¥ och returnerar 2 låtar. Statusfrågor, WAV, tidsstämplade texter och promptförslag kostar inget extra.

Vilka modeller stöds? suno-v6 (standard), suno-v6-wild och suno-v6-mini. Standardmodellerna v5.5 och äldre är avvecklade; befintliga verk påverkas inte.

Vad är bas-URL:en? https://www.suno-api.io, med headern Authorization: Bearer YOUR_API_KEY.

Modeller som finns nu

Vid vanlig låtgenerering kan kunden bara ange suno-v6, suno-v6-wild och suno-v6-mini. Om model utelämnas används suno-v6.

Standardmodellerna suno-v2, suno-v3, suno-v3-5, suno-v4, suno-v4-5, suno-v4-5-all, suno-v4-5-plus, suno-v5 och suno-v5-5 är avvecklade. I historiska uppgifter kan namnen fortfarande synas, men det är historik och betyder inte att modellen går att använda för nya anrop. Undantaget är stems-separation — se Stems-API (separera sång och komp).

Autentisering

Alla publika API-nyckeländpunkter använder samma headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Bas-URL:

https://www.suno-api.io

Allmänna parameterregler

• En number i förfrågan måste vara ett JSON-tal, aldrig en procentsträng. Intensiteten 50 % skrivs 0.5, aldrig 50 eller 50%.
• En boolean måste vara true eller false. Skicka inte true, false, 0 eller 1 som ersättning.
• Fält markerade med "nej" kan utelämnas helt. Om du är osäker på en parameter: utelämna den och låt tjänsten använda sitt standardbeteende. Skicka inte tom sträng, null eller 0 i stället för "inte skickat", eftersom 0 är ett giltigt värde i vissa numeriska fält.
• Fältnamn är känsliga för stavning. Varje sida anger rekommenderat fält och kompatibla alias; skicka dem exakt som i tabellen. Där dokumentationen säger att snake_case och camelCase båda fungerar ska du inte skicka båda.
• Alla varaktighetsfält som slutar på _s eller Seconds är i sekunder och tar decimaler. Unix-tidsstämplar beskrivs separat, inklusive om de är i sekunder eller millisekunder.
• Ett ID som börjar med pending: är en platshållare från plattformen, inte ett riktigt låt-ID. Använd det bara där ändpunkten uttryckligen dokumenterar det; vänta annars på det riktiga song_id.

Gränser för textfält

Om gränsen överskrids returneras HTTP 400 direkt: inget genereras, inget fördebiteras och ingen uppgift skapas. Räkningen sker i Unicode-tecken (ett ideogram räknas som 1) och blanksteg i början och slutet räknas med.

Felmeddelandet (message) anger fältet och den uppmätta längden; de två talen räcker för att korta texten:

{
  "error": {
    "message": "style_tags must not exceed 1000 characters; received 2772",
    "type": "invalid_request_error"
  }
}

Gäller: /api/music/create, /api/music/create/custom, /api/music/extend, /api/music/upload-cover, /api/music/generate-from-source, /api/music/add-instrumental, /api/music/add-vocal, /api/music/add-stem, /api/music/mashup, /api/music/sample, /api/music/inspo, /api/music/crop, /api/music/remove-section, /api/music/fade, /api/music/reverse, /api/music/speed, /api/music/replace-section, /api/music/generate-with-voice.

Ett undantag: description i POST /api/music/sounds är begränsat till 100 tecken, eftersom ljudeffektvägen använder plattformens kortare gräns.

Asynkron generering och ljudadresser

Genereringsändpunkterna arbetar asynkront som standard. När det första svaret har status lika med pending, submitted eller processing är tomma audio_url, video_url och cover_url normalt och betyder inte att uppgiften misslyckats. Spara det riktiga song_id (eller det returnerade client_request_id) och polla rätt ändpunkt; läs och ladda ned en ljudadress först när status är klar.

⚠️ Ljudadresser går ut efter 7 dagar — flytta filerna i tid

audio_url, wav_url, video_url och adresserna från nedladdningsändpunkterna levereras från plattformens objektlagring och går ut efter 7 dagar som standard (filerna återvinns; en gammal adress ger 404 / går inte att ladda ned).

• Inom de 7 dagarna: flytta filerna till din egen lagring (egen objektlagring, CDN eller serverdisk). Behandla inte våra adresser som långsiktiga länkar.
• En utgången adress kräver ingen ny generering och kostar inget extra: anropa låtsöknings-API:t (eller medienedladdnings-API:t) igen för att få en ny giltig adress.

Väntetider och tidsgränser

Genereringsändpunkterna är synkrona: beställningen accepteras och skickas till plattformen först när svaret kommer. Dessförinnan måste tjänsten schemalägga ett konto och passera nödvändig säkerhetskontroll, och det finns inget mellansvar — ingen annan ändpunkt ser beställningen. Det enda tillförlitliga beviset på att "något genererades" är därför själva svaret, inte det man observerar medan man väntar.

Uppmätta väntetider (produktion, /api/music/create-familjen, 18–20 september 2026)

• Cirka 10 % av anropen tar över 30 sekunder och cirka 1 % tar 1–2 minuter. Långsamma anrop betyder oftast att just detta först behövde en säkerhetskontroll.
• Fält, svarsform, felkoder och fakturering är oförändrade, så befintliga integrationer behöver bara höja klientens tidsgräns — ingen annan kodändring.

Krav för integration

1. Sätt klientens tidsgräns till 300 sekunder eller mer. Klienter med 30, 60 eller 120 sekunder kopplar ned under väntan.
2. Inget svar betyder inte att inget genererades. Vid tidsgräns eller bruten anslutning kan beställningen redan vara accepterad och genereras.
3. Försök inte igen direkt efter en tidsgräns: en dubbel inskickning skapar en andra beställning och debiterar igen.
4. Om anslutningen bröts: lista dina låtar med GET /api/music/songs (nyaste först) en stund senare — accepterade beställningar visas normalt. Skicka igen först efter att du bekräftat att beställningen verkligen saknas.
5. Vid felanmälan: bifoga svarshuvudet X-Oneapi-Request-Id så att just den förfrågan kan hittas.

Vill du inte hålla en lång anslutning? Använd kvittoläge. POST /api/music/create och POST /api/music/create/custom stödjer ett valfritt kvitto: lägg till "accept_mode": "async" i kroppen (eller headern X-Accept-Mode: async) och ändpunkten svarar direkt 202 med ett kvittonummer medan genereringen fortsätter i bakgrunden; följ förloppet med GET /api/music/requests/{request_id}. En klient med bara några tiotals sekunders tidsgräns kan då inte missta "inget svar" för "inget genererat", och inte heller debiteras två gånger via omförsök. Se "Kvittoläge" i API för generering i enkelt läge.

Som referens: python requests använder timeout=300, urllib använder urlopen(..., timeout=300), Node använder req.setTimeout(300000), curl använder --max-time 300.

Rekommenderade ändpunkter

Ändpunkterna /api/voice/clone/* och /api/music/generate-with-voice tillhör den tidiga röstkloningskedjan och rekommenderas inte för nya integrationer; använd i stället 【Rekommenderas】 röstprofil-API:t.

Avancerade parametrar: Max Mode och Variety

Genereringsändpunkterna stödjer dessa två valfria parametrar (utelämnas de behålls beteende och pris):

Stöds av: POST /api/music/create, POST /api/music/create/custom, POST /api/music/extend, POST /api/music/upload-cover, POST /api/music/generate-from-source, POST /api/music/add-instrumental, POST /api/music/add-vocal, POST /api/music/add-stem, POST /api/music/mashup, POST /api/music/sample, POST /api/music/inspo, POST /api/music/replace-section, POST /api/music/voice-profile/cover, POST /api/music/speech.

• Dubbelt pris i praktiken: en ändpunkt på 0,6 ¥ per anrop blir 1,2 ¥ med max_mode; generera med en vald röst kostar 1,2 ¥ per anrop och 2,4 ¥ med Max Mode; röstcovern i 【Rekommenderas】 röstprofil-API:t kostar också 1,2 ¥ per anrop (2,4 ¥ med max_mode).
• variety gäller bara suno-v6-familjen (suno-v6, suno-v6-wild, suno-v6-goose motsvarande suno-v6-mini); med andra modeller returneras 400.
• Ljudeffekter, stems, concat, WAV och Studio-redigeringarna (beskärning, ta bort avsnitt, tona, baklänges, hastighet med flera) har inte dessa parametrar — skickas de explicit returneras 400, så att en parameter aldrig tystas ned.
• variety är heltal 0-4; style_weight och weirdness_constraint är decimaler 0-1, så skalorna skiljer sig.

Gemensamma svarsfält för låtar

Genererings-, cover-, extend-, separerings- och frågeändpunkter returnerar oftast en array av låtar med dessa fält:

Fyra steg för integration (minimalt exempel)

Med dessa fyra steg får du din första låt; alla fält per steg finns på respektive sida i listan över rekommenderade ändpunkter.

# 1) Skicka en generering: 0,6 ¥, returnerar 2 låtar
curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "bright Swedish pop, piano intro, warm female vocal", "model": "suno-v6"}'

# 2) Polla tills status är completed (3–5 sekunder är ett bra intervall)
curl -X POST https://www.suno-api.io/api/music/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id": "song_id från steg 1"}'

# 3) Hämta en mediaadress: läsändpunkter är gratis; song / wav / video / cover / midi
curl -X POST https://www.suno-api.io/api/music/download-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id": "samma song_id", "kind": "song"}'

Om något går fel: 401 / 402 / 403 / 429 i fellistan; tidsgränser och dubbeldebiteringar i avsnittet ovan; varje ändpunkts detaljer i listan nedan.

Rekommendationer

• Nya integrationer bör använda suno-v6 överallt.
• För ändpunkter med standardpris följer det faktiska beloppet den aktuella prisinställningen i backoffice och den begärda modellen.
• Genereringsändpunkter returnerar först en uppgift; hämta det färdiga ljudet via /api/music/query.
• wait_completion=true blockerar till dess det är klart och passar lågvolymstester; i produktion är asynkron polling bättre.
• Genereringen kan ta lång tid — sätt klientens tidsgräns till 300 sekunder eller mer och kom ihåg att "inget svar" inte är samma sak som "inget genererat".
• Uppladdning, cover, byte och WAV beror på plattformskonton och rättigheter till källklippet; läs message eller error_message först vid fel.

Om dokumentationen

Sidan har strukturerats om efter de funktioner Create UI faktiskt erbjuder; nya integrationer bör börja här. Den äldre API-dokumentationen finns kvar under "Äldre API-dokumentation (kompatibel)" för den som vill behålla sitt tidigare arbetssätt.