Stil-Boost-API

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

Beschreibung des Endpunkts

Der Stil-Boost erweitert ein kurzes Stil-Tag zu einer vollständigeren Stilbeschreibung, die für die Suno-Generierung besser geeignet ist, und kann aus vollständigem Songtext auch einen Stilabschnitt erzeugen.

Endpunkt: POST /api/music/boost-style

Abrechnung: Im Kontingent kostenlos (höchstens 10 Aufrufe pro Minute und 300 pro Tag je Nutzer); darüber hinaus 0,1 ¥ pro Aufruf.

Überschreitung erkennen: Wird das kostenlose Kontingent überschritten, läuft die Anfrage trotzdem normal, und die Antwort-Header enthalten X-Suno-Helper-Free: false und X-Suno-Helper-Over-Limit: minute (oder day), sodass der Client darauf hinweisen kann, dass dieser Aufruf berechnet wurde.

Empfohlenes Modell: suno-v6. Verfügbar sind suno-v6, suno-v6-wild und suno-v6-mini.

Chinesische Ausgabe: Enthält der Anfrageinhalt (originalTags/lyrics/user_guidance) Chinesisch und ist keine Sprache angegeben, hängt der Dienst automatisch （请用中文描述） an original_tags an und ergänzt user_guidance=语言：简体中文；乐器名也用中文, um die Trefferquote chinesischer Stilbeschreibungen zu erhöhen. Die tatsächlich übermittelten Werte werden in appliedOriginalTags und appliedUserGuidance der Antwort zurückgegeben. Ist im gesendeten Inhalt bereits eine Sprache genannt (zum Beispiel „auf vereinfachtem Chinesisch beschreiben"), ändert der Dienst nichts.

Authentifizierung

Anfrageparameter

Beispielanfrage

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nDie Nacht fällt hinter das Fenster\n[Chorus]\nWir gehen dem Licht entgegen",
    "user_guidance": "Suona und Erhu hinzufügen, männliche Stimme, schnelleres Tempo",
    "instrumental": false
  }'

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle ist die vollständige Stilbeschreibung, die in das Style-Feld zurückgeschrieben werden sollte.