Autentisering

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

Alla anrop till Suno-API autentiseras med en API-nyckel. Den här sidan beskriver hur nyckeln skapas, hur den skickas, vad felen betyder och hur du håller nyckeln säker.

Vad en API-nyckel är

Nyckeln är en bearer-token kopplad till ditt konto. Den bär saldot, så den som har nyckeln kan använda det. Nyckeln visas bara en gång vid skapandet: kopiera den och förvara den säkert.

Skapa en nyckel

1. Registrera dig på https://www.suno-api.io — bara e-post, inget telefonnummer.
2. Öppna tokenhanteringen i konsolen.
3. Skapa en ny nyckel och kopiera den.

Nycklar har formen sk-…. En förlorad nyckel går inte att återställa: skapa en ny och ta bort den gamla.

Använda nyckeln

Format för rubriken

Skicka nyckeln i rubriken Authorization i varje anrop:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Exempel

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "ett lugnt pianostycke för ett kafé"}'

Autentiseringsfel

401 Unauthorized

Rubriken saknas, är felaktig eller så finns inte nyckeln.

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Kontrollera att rubriken är exakt Bearer <nyckel> (med ett mellanslag efter Bearer) och att inget radbrytningstecken hamnat i slutet av nyckeln.

403 Forbidden

Nyckeln finns men får inte utföra anropet — oftast för att nyckeln inaktiverats eller kontot stängts av. Kontrollera kontostatusen i konsolen och kontakta supporten om orsaken inte är uppenbar.

Bästa praxis för säkerhet

Lägg aldrig nyckeln i klientkod

Bädda inte in nyckeln i webbsidor, mobilappar eller skrivbordsprogram. Den som öppnar webbläsarens granskningsverktyg kan läsa den och använda ditt saldo. Anropa API:et från din egen server och exponera din egen ändpunkt mot användarna.

Använd miljövariabler

Linux / macOS

# ~/.bashrc eller ~/.zshrc
export SUNO_API_KEY="sk-your-key-here"

# Python
import os
api_key = os.environ["SUNO_API_KEY"]

.env

# .env-fil — lägg den i .gitignore
SUNO_API_KEY=sk-your-key-here

Windows

setx SUNO_API_KEY "sk-your-key-here"

Node.js

require('dotenv').config();
const apiKey = process.env.SUNO_API_KEY;

Rotera nyckeln vid behov

Roterar du nycklar var 3-6:e månad, och direkt vid misstänkt läcka. Ta bort nycklar du inte längre använder: en oanvänd nyckel är bara en oanvänd risk.

Anropsgräns

Anrop begränsas per nyckel:

429 Too Many Requests

Överskrider du en gräns svarar API:t 429, och svaret kan innehålla ett retry_after-värde i sekunder. Vänta så länge före nästa försök; sänk takten, köa arbetet eller försök igen med exponentiell backoff i stället för i en tät loop.

Policy för nya försök

Försök bara igen vid tydliga fel. Försök inte igen efter en läs- eller anslutningstimeout: genereringsändpunkter är synkrona, så en timeout kan betyda att beställningen redan accepterats och genereras — ett nytt försök skapar en dubblett och debiterar två gånger. Ställ in klientens timeout på 300 sekunder eller mer och kontrollera beställningen med GET /api/music/songs efter ett avbrott innan du skickar igen. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.

Skicka igen med exponentiell backoff i stället för i en tät loop:

import time

delay = 1.0
for attempt in range(5):
    response = call_api()
    if response.status_code != 429:
        break
    time.sleep(delay)
    delay *= 2

Vanliga frågor

Vad har nyckeln för format?

Den börjar med sk- följt av bokstäver och siffror, totalt ungefär 50-60 tecken.

Kan jag anropa API:et direkt från webbläsaren?

Tekniskt sett ja, men gör inte det i produktion: nyckeln blir synlig för alla besökare. Proxya via din egen backend.

Hur vet jag att nyckeln fortfarande fungerar?

Skicka ett autentiserat anrop. 200 betyder att den fungerar; 401 betyder ogiltig eller borttagen nyckel.

Jag har tappat nyckeln. Vad gör jag?

Nycklar går inte att återställa. Skapa en ny i konsolen och ta bort den gamla.

Hur många nycklar kan ett konto ha?

Det finns ingen fast gräns. Använd en nyckel per applikation eller miljö så att du kan återkalla dem var för sig, och ta bort dem du slutar använda.

Går nycklar ut?

De gäller tills du tar bort dem eller avslutar kontot. Regelbunden rotation är god praxis.

Hur följer jag användningen?

Logga in i konsolen: där listas användningen per nyckel, med antal anrop, kostnad och senaste uppgifter.

Relaterade sidor

• Snabbstart
• Modeller som stöds