API de generare a efectelor sonore

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

Descrierea endpoint-ului

Generarea efectelor sonore creează câteva secunde de audio, nu o piesă. Este potrivită pentru sunete scurte precum tunet, picături de ploaie sau un impact și funcționează și pentru efecte de tranziție, ambianță și loop-uri de tobe; majoritatea durează sub 5 secunde, iar cel mai lung în jur de 20 de secunde. Sunt acceptate modurile unic și buclă.

Endpoint: POST /api/music/sounds

Facturare: Cu plată, momentan implicit 0,6 CNY per apel. Suma efectiv debitată urmează configurația actuală de prețuri din back-office.

Timpii de așteptare și timeout-urile (important): este un endpoint sincron — comanda este acceptată și transmisă spre generare doar când sosește răspunsul. Din măsurători, majoritatea cererilor răspund în 1-3 secunde, circa 10% depășesc 30 de secunde, iar cea mai lungă este de aproximativ 230 de secunde. Setează timeout-ul clientului la 300 de secunde sau mai mult; lipsa unui răspuns nu înseamnă că nu s-a generat nimic, iar reîncercarea imediat după un timeout dublează comanda și debitează din nou. Dacă conexiunea s-a întrerupt, verifică mai târziu cu GET /api/music/songs. Vezi „Timpii de așteptare și setarea timeout-ului” în Prezentarea noului API.

Parametrii cererii

Headers

Parametru	Tip	Obligatoriu	Observații
Authorization	string	da	Bearer YOUR_API_KEY
Content-Type	string	da	application/json

Parametri din body

Parametru	Tip	Obligatoriu	Implicit	Observații
model	string	nu	suno-v6	Nume de model pentru client: `suno-v6`, `suno-v6-wild` sau `suno-v6-mini`
description	string	da	-	Descrie sunetul dorit; frazele scurte în engleză funcționează cel mai fiabil, de exemplu `cinematic whoosh transition, bright impact`
title	string	nu	-	Titlu; dacă nu este trimis, poate fi generat din descriere
type	string	nu	one_shot	Tip: `one_shot` (unic) sau `loop` (buclă)
loop	boolean	nu	false	Dacă se repetă în buclă; echivalent cu a seta `type` pe `loop`
bpm	number	nu	-	BPM; trebuie să fie un număr mai mare decât 0. O valoare invalidă returnează 400 (`invalid_sound_bpm`) în loc să fie ignorată în tăcere
key	string	nu	-	Tonalitate, în formatul numelui notei (C-B) + `#`/`b` opțional + `Major`/`Minor` opțional, de exemplu `C Major`, `C#m`, `Bb`; gol sau `any` înseamnă fără restricție. O valoare invalidă returnează 400 (`invalid_sound_key`)

Exemplu de cerere

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Răspuns

Se returnează un array de piese; câmpurile sunt aceleași ca în câmpurile comune de răspuns pentru piesă din Prezentarea noului API.

UrmătorulAPI de generare a versurilor

Obține o cheie API

Creează o cheie API în consolă după înregistrare. Fiecare generare costă 0,6 ¥ și returnează 2 piese, descărcările sunt nelimitate și nu este nevoie de număr de telefon.

Obține cheia API Înapoi la prezentare