Songtext-Generierungs-API

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

Beschreibung des Endpunkts

Die Songtext-Generierung erstellt oder überarbeitet Songtexte anhand eines Themas, vorhandenem Songtext-Kontext und Stilvorgaben. Der Endpunkt ist bereits auf den neuesten Songtext-Generierungsvertrag umgestellt und kann direkt für die Generierung im Profi-Modus genutzt werden.

Endpunkt: POST /api/lyrics/generate

Abrechnung: Kostenlos im Kontingent (pro Nutzer höchstens 10 Aufrufe pro Minute und 300 pro Tag); über dem Gratis-Kontingent 0,1 CNY pro Aufruf.

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

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

Authentifizierung

Anfrageparameter

instruction akzeptiert auch die alten Felder theme und prompt. metadata.lyrics_model ist standardmäßig default, metadata.enable_thinking standardmäßig false.

Sprachsteuerung

Dieser Endpunkt hat kein eigenes language-Anfragefeld. Die Sprache des Songtexts bestimmt der Inhalt von instruction; style kann nur eine unterstützende Rolle spielen.

Um einen chinesischen Songtext zu erzeugen, geben Sie die Zielsprache ausdrücklich in instruction an, zum Beispiel:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Sie können auch "Write the lyrics in Chinese about ..." schreiben. Für englische Songtexte schreiben Sie "请用英文写歌词" oder "Write the lyrics in English". Wenn Sie nur ein englisches Thema ohne Angabe der Zielsprache übergeben, kann das Ergebnis englisch sein.

Beispielanfrage

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Ein deutscher Songtext über die Abschlusszeit und den Neuanfang",
    "style": "Pop-Rock, aufrichtig, einprägsamer Refrain",
    "title": "Neuanfang",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nDer Wind zieht über den Schulhof\nWir winken dem Gestern zu",
    "edited_lyrics": "[Verse]\nDer Wind zieht über den Schulhof\nWir winken dem Gestern zu",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics ist der vollständige Songtext, der in das Songtext-Feld eingetragen werden sollte. lyrics_id und lyrics_request_id dienen der Nachverfolgung und können je nach Rückgabe des Endpunkts leer sein; behandeln Sie sie nicht als Song-IDs.

Kompatibilitätshinweise

• Die alten Felder theme und prompt funktionieren weiterhin und werden auf instruction abgebildet.
• Die Endpunkt-Serie Songtext-Projekt / Textdichter ist eingestellt: Wenn Sie generierte Ergebnisse behalten müssen, speichern Sie das vom Endpunkt zurückgegebene edited_lyrics selbst.