Autentificare

Actualizat pe 2026-09-18 · echipa Suno-API

Toate cererile către Suno-API sunt autentificate cu o cheie API. Această pagină explică modul în care creezi cheia, cum o trimiți, ce înseamnă erorile și cum o păstrezi în siguranță.

Ce este o cheie API

Cheia este un token bearer legat de contul tău. Poartă soldul, deci cine are cheia poate cheltui banii. Cheia este afișată o singură dată la creare: copiaz-o și păstreaz-o într-un loc sigur.

Crearea unei chei

1. Înregistrează-te pe https://www.suno-api.io — doar e-mail, fără număr de telefon.
2. Deschide gestionarea tokenurilor în consolă.
3. Creează o cheie nouă și copiaz-o.

Cheile au forma sk-…. O cheie pierdută nu poate fi recuperată: creează alta și șterge-o pe cea veche.

Folosirea cheii

Formatul antetului

Trimite cheia în antetul Authorization la fiecare cerere:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Exemplu

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "o piesă calmă de pian pentru o cafenea"}'

Erori de autentificare

401 Unauthorized

Antetul lipsește, este greșit sau cheia nu există.

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

Verifică dacă antetul este exact Bearer <cheie> (cu spațiu după Bearer) și dacă nu a intrat un caracter de linie nouă la finalul cheii.

403 Forbidden

Cheia există, dar nu are permisiunea pentru această cerere — cel mai des pentru că a fost dezactivată sau contul este suspendat. Verifică starea contului în consolă și contactează suportul dacă motivul nu este evident.

Bune practici de securitate

Nu pune niciodată cheia în codul clientului

Nu include cheia în pagini web, aplicații mobile sau programe desktop. Oricine deschide inspectorul browserului o poate citi și poate cheltui soldul tău. Apelează API-ul de pe propriul server și expune utilizatorilor endpointul tău.

Folosește variabile de mediu

Linux / macOS

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

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

.env

# fișier .env — adaugă-l în .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;

Rotește cheia când e nevoie

Rotește cheile la fiecare 3-6 luni și imediat dacă bănuiești o scurgere. Șterge cheile pe care nu le mai folosești: o cheie nefolosită este doar un risc nefolosit.

Limita de cereri

Cererile sunt limitate pe cheie:

429 Too Many Requests

Când depășești o limită, API-ul răspunde 429, iar răspunsul poate conține o valoare retry_after în secunde. Așteaptă atât înainte de următoarea încercare; reduce ritmul, pune lucrul în coadă sau reîncearcă cu backoff exponențial în loc de buclă strânsă.

Politica de reîncercare

Reîncearcă doar la erori explicite. Nu reîncerca după un timeout de citire sau de conexiune: endpointurile de generare sunt sincrone, deci un timeout poate însemna că comanda a fost deja acceptată și se generează — reîncercarea creează o comandă duplicat și taxează de două ori. Setează timeout-ul clientului la 300 de secunde sau mai mult și, după o conexiune întreruptă, verifică comanda cu GET /api/music/songs înainte de a o retrimite. Vezi „Timpii de așteptare și setarea timeout-ului” în Prezentarea noului API.

Reîncearcă cu backoff exponențial în loc de o buclă strânsă:

import time

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

Întrebări frecvente

Care este formatul cheii?

Începe cu sk- urmat de litere și cifre, în total circa 50-60 de caractere.

Pot apela API-ul direct din browser?

Tehnic da, dar nu face asta în producție: cheia ar fi vizibilă tuturor vizitatorilor. Folosește propriul backend ca proxy.

Cum știu dacă cheia mai este validă?

Trimite orice cerere autentificată. 200 înseamnă că funcționează; 401 înseamnă cheie invalidă sau ștearsă.

Am pierdut cheia. Ce fac?

Cheile nu pot fi recuperate. Creează una nouă în consolă și șterge-o pe cea veche.

Câte chei poate avea un cont?

Nu există o limită fixă. Folosește o cheie pentru fiecare aplicație sau mediu ca să le poți revoca separat și șterge-le pe cele pe care nu le mai folosești.

Cheile expiră?

Sunt valabile până le ștergi sau închizi contul. Rotația periodică este o bună practică.

Cum urmăresc consumul?

Autentifică-te în consolă: acolo apare utilizarea pe fiecare cheie — număr de cereri, cheltuieli și sarcini recente.

Pagini conexe

• Ghid rapid
• Modele acceptate