Suno-API-Dokumentation – Musik aus einem Prompt generieren (V5 / V5.5), einschließlich Preisen

Suno ist ein erstklassiges KI-Musikmodell – es generiert aus einem Text-Prompt vollständige Songs mit Gesang, Text und Instrumentierung. Die Suno API (Suno V5 und V5.5 auf Kunavo) erledigt dies programmatisch über POST /v1/audio/music und gibt gehostete Audiotracks mit einem einzigen Bearer-Token zurück. Dies ist die praktische Dokumentation: Request-Format, Preise und das asynchrone Muster für den Produktionseinsatz.

Suno API aufrufen

Erstellen Sie unter /app/keys einen Schlüssel und senden Sie einen POST mit einem Prompt. Eine Anfrage gibt ungefähr zwei Track-Varianten zurück; die Generierung dauert einige Dutzend Sekunden bis einige Minuten:

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

Vollständige Parameter und der Lebenszyklus asynchroner Aufgaben finden Sie in der Referenz zur Musik-API.

Preise

Suno wird pro Generierungsanfrage abgerechnet, nicht pro Track; die ungefähr zwei zurückgegebenen Varianten kosten daher eine Gebühr. Aktuelle Preise finden Sie auf jeder Modellseite. Suno selbst veröffentlicht keinen API-Preis pro Anfrage – die eigene API ist ein ausschließlich Partnern zugängliches Programm ohne öffentliche Preise –, daher zeigt die Tabelle nur, was Kunavo berechnet.

Pay-as-you-go ab einer Mindestaufladung von 10 $, das Guthaben verfällt nie, fehlgeschlagene Generierungen werden nie berechnet. Schätzen Sie einen größeren Workload mit dem Kostenrechner.

Benutzerdefinierter Modus: eigene Texte

Statt eines einfachen Prompts geben Sie lyrics, eine style-Beschreibung und einen title an, um vollständige Kontrolle zu erhalten, oder setzen Sie instrumental: true, um Gesang vollständig zu überspringen:

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

Asynchron in der Produktion

Musikgenerierung erfolgt nicht sofort; senden Sie bei größerem Umfang daher eine Aufgabe und fragen Sie das Ergebnis ab, statt die Verbindung offen zu halten – die Musikdokumentation behandelt Aufgabenlebenszyklus, Abfragen und Webhook-Zustellung. Ergebnis-URLs sind nach Abschluss dauerhaft.

Kunavo vs. direkte Nutzung von Suno

Sunos eigenes Produkt ist ein Abonnement mit einem enthaltenen Guthaben, keine verbrauchsabhängige Pay-as-you-go-API – genau deshalb suchen Entwickler überhaupt nach einer „Suno API“:

Wenn Sie Musik in ein Produkt integrieren, sind verbrauchsabhängige Abrechnung und ein echter Endpunkt der entscheidende Punkt. Wenn ein Mensch im Browser manuell Tracks erstellt, ist Sunos eigenes Abonnement der einfachere Kauf.

Suno API vs. Udio API

Udio ist die andere führende Familie für Musikgenerierung, und „Udio API“ ist eine häufige parallele Suchanfrage. Der praktische Unterschied heute: Der API-Zugriff von Udio läuft über experimentelle Drittanbieterwege ohne stabilen öffentlichen Preis, während Suno V5 / V5.5 auf Kunavo ein unterstützter Endpunkt mit einem festen, veröffentlichten Preis ist ($0.09 pro Generierungsanfrage). Wenn Sie zuverlässige Musikgenerierung in Produktion benötigen, ist die Suno V5 API hier der verlässliche Weg; wir bewerten Udio, sobald ein stabiler Upstream existiert.

Über Musik hinaus

Derselbe Schlüssel erreicht Text (Claude, GPT), Bilder (Nano Banana, GPT-Image-2) und Videos (Veo 3, Seedance 2, Wan 2.7), sodass Sie eine vollständige Pipeline verknüpfen können: Skript mit einem LLM erstellen, Visuals generieren und einen Suno-Soundtrack hinzufügen. Der Leitfaden für multimodale KI behandelt Workflows von Bild → Video → Musik.

Häufig gestellte Fragen