Soundeffekt-API

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Soundeffekte erzeugen einige Sekunden Audio, keinen Song. Sie eignen sich für kurze Geräusche wie Donner, Regentropfen oder einen Einschlag und ebenso für Übergangseffekte, Ambiente und Drum-Loops; die meisten sind unter 5 Sekunden, das längste etwa 20 Sekunden. Unterstützt werden Einzel- und Loop-Modus.

Endpunkt: POST /api/music/sounds

Abrechnung: Kostenpflichtig, derzeit standardmäßig 0,6 CNY pro Aufruf. Der tatsächlich berechnete Betrag folgt der aktuellen Preis-Konfiguration im Backoffice.

Wartezeiten und Timeouts (wichtig): Dies ist ein synchroner Endpunkt — die Bestellung wird erst angenommen und der Generierung übergeben, wenn die Antwort eintrifft. Gemessen antworten die meisten Anfragen in 1-3 Sekunden, etwa 10 % brauchen länger als 30 Sekunden und die längste liegt bei rund 230 Sekunden. Setzen Sie den Client-Timeout auf 300 Sekunden oder mehr; keine Antwort bedeutet nicht, dass nichts generiert wurde, und wiederholen Sie nicht direkt nach einem Timeout (das dupliziert die Bestellung und berechnet erneut). Wenn die Verbindung abbrach, prüfen Sie später mit GET /api/music/songs. Siehe „Wartezeiten und Timeout-Einstellungen“ in der Übersicht der neuen API.

Anfrageparameter

Headers

Parameter	Typ	Erforderlich	Hinweise
Authorization	string	ja	Bearer YOUR_API_KEY
Content-Type	string	ja	application/json

Body-Parameter

Parameter	Typ	Erforderlich	Standard	Hinweise
model	string	nein	suno-v6	Modellname für Kunden: `suno-v6`, `suno-v6-wild` oder `suno-v6-mini`
description	string	ja	-	Beschreiben Sie den gewünschten Klang; kurze englische Phrasen funktionieren am zuverlässigsten, z. B. `cinematic whoosh transition, bright impact`
title	string	nein	-	Titel; wird er weggelassen, kann er aus der Beschreibung erzeugt werden
type	string	nein	one_shot	Typ: `one_shot` (einmalig) oder `loop` (Schleife)
loop	boolean	nein	false	Ob in Schleife; entspricht `type` = `loop`
bpm	number	nein	-	BPM; muss eine Zahl größer als 0 sein. Ein ungültiger Wert liefert 400 (`invalid_sound_bpm`) statt stillschweigend ignoriert zu werden
key	string	nein	-	Tonart im Format Notenname (C-B) + optional `#`/`b` + optional `Major`/`Minor`, z. B. `C Major`, `C#m`, `Bb`; leer oder `any` bedeutet ohne Einschränkung. Ein ungültiger Wert liefert 400 (`invalid_sound_key`)

Beispielanfrage

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"
  }'

Antwort

Es wird ein Array von Songs zurückgegeben; die Felder entsprechen den allgemeinen Song-Antwortfeldern in der Übersicht der neuen API.

WeiterSongtext-Generierungs-API

API-Schlüssel erhalten

Erstellen Sie nach der Anmeldung einen API-Schlüssel in der Konsole. Jede Generierung kostet 0,6 ¥ und liefert 2 Tracks, Downloads sind unbegrenzt und eine Telefonnummer ist nicht erforderlich.

API-Schlüssel holen Zurück zur Übersicht