Uwierzytelnianie

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

Wszystkie żądania do Suno-API są uwierzytelniane kluczem API. Ta strona opisuje, jak utworzyć klucz, jak go przesyłać, co oznaczają błędy i jak bezpiecznie go przechowywać.

Czym jest klucz API

Klucz to token bearer powiązany z Twoim kontem. Niesie ze sobą saldo, więc kto ma klucz, ten może je wydać. Klucz jest pokazywany tylko raz przy tworzeniu: skopiuj go i zapisz w bezpiecznym miejscu.

Tworzenie klucza

1. Zarejestruj się na https://www.suno-api.io — wystarczy e-mail, bez numeru telefonu.
2. Otwórz zarządzanie tokenami w konsoli.
3. Utwórz nowy klucz i skopiuj go.

Klucze mają postać sk-…. Utraconego klucza nie da się odzyskać: utwórz nowy, a stary usuń.

Używanie klucza

Format nagłówka

Przesyłaj klucz w nagłówku Authorization w każdym żądaniu:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Przykład

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "spokojny utwór fortepianowy do kawiarni"}'

Błędy uwierzytelniania

401 Unauthorized

Nagłówek jest nieobecny, błędny albo klucz nie istnieje.

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

Sprawdź, czy nagłówek ma dokładnie postać Bearer <klucz> (ze spacją po Bearer) i czy na końcu klucza nie znalazł się znak nowej linii.

403 Forbidden

Klucz istnieje, ale nie ma uprawnień do tego żądania — najczęściej dlatego, że klucz wyłączono lub konto zawieszono. Sprawdź stan konta w konsoli i skontaktuj się ze wsparciem, jeśli przyczyna nie jest oczywista.

Dobre praktyki bezpieczeństwa

Nigdy nie umieszczaj klucza w kodzie klienta

Nie osadzaj klucza w stronach internetowych, aplikacjach mobilnych ani programach desktopowych. Każdy, kto otworzy inspektor przeglądarki, może go odczytać i wydać Twoje saldo. Wywołuj API ze własnego serwera i udostępniaj użytkownikom własny endpoint.

Używaj zmiennych środowiskowych

Linux / macOS

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

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

.env

# plik .env — dopisz go do .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;

Rotuj klucz, gdy trzeba

Wymieniaj klucze co 3-6 miesięcy, a natychmiast gdy podejrzewasz wyciek. Usuwaj klucze, których już nie używasz: nieużywany klucz to tylko nieużywane ryzyko.

Limit żądań

Żądania są limitowane na klucz:

429 Too Many Requests

Po przekroczeniu limitu API zwraca 429, a odpowiedź może zawierać wartość retry_after w sekundach. Odczekaj tyle przed kolejną próbą; zmniejsz tempo żądań, ustaw pracę w kolejce lub ponawiaj z wykładniczym opóźnieniem zamiast w ciasnej pętli.

Zasady ponawiania

Ponawiaj tylko przy jednoznacznych błędach. Nie ponawiaj po limicie czasu odczytu lub połączenia: punkty końcowe generowania są synchroniczne, więc limit czasu może oznaczać, że zamówienie zostało już przyjęte i jest generowane — ponowienie tworzy duplikat i pobiera opłatę dwa razy. Ustaw limit czasu klienta na 300 sekund lub więcej, a po zerwaniu połączenia sprawdź zamówienie przez GET /api/music/songs, zanim wyślesz je ponownie. Zobacz „Czasy oczekiwania i ustawienia limitu czasu” w Przeglądzie nowego API.

Ponawiaj z wykładniczym opóźnieniem zamiast w ciasnej pętli:

import time

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

Częste pytania

Jaki jest format klucza?

Zaczyna się od sk-, po czym następują litery i cyfry — łącznie około 50-60 znaków.

Czy mogę wywoływać API prosto z przeglądarki?

Technicznie tak, ale nie rób tego w produkcji: klucz byłby widoczny dla wszystkich odwiedzających. Użyj własnego backendu jako proxy.

Skąd wiem, że klucz jest nadal ważny?

Wyślij dowolne uwierzytelnione żądanie. 200 oznacza, że działa; 401 oznacza nieprawidłowy lub usunięty klucz.

Zgubiłem klucz. Co teraz?

Kluczy nie da się odzyskać. Utwórz nowy w konsoli i usuń stary.

Ile kluczy może mieć jedno konto?

Nie ma stałego limitu. Używaj osobnego klucza na aplikację lub środowisko, aby móc je niezależnie unieważniać, i usuwaj te, których przestajesz używać.

Czy klucze wygasają?

Działają, dopóki ich nie usuniesz lub nie zamkniesz konta. Okresowa rotacja to dobra praktyka.

Jak śledzić zużycie?

Zaloguj się do konsoli: znajdziesz tam użycie każdego klucza — liczbę żądań, wydatki i ostatnie zadania.

Powiązane strony

• Szybki start
• Obsługiwane modele