Suno API: offizieller Status, API-Schlüssel und ein Python-Beispiel

Stand 17. Oktober 2026 hat Suno eine offizielle API, doch anmelden kann man sich nicht: platform.suno.com zeigt nur eine Anmeldung für bestehende API-Konten, ohne öffentliche Dokumentation, Preise oder Selbstbedienung, und Suno sagte im Juli, dass es mit einer ausgewählten Gruppe von Partnern beginnt. Ohne Einladung funktionieren heute zwei andere Wege.

Gibt es eine offizielle Suno-API?

Suno bewirbt eine API auf platform.suno.com, und diese eine Seite ist die gesamte öffentliche Fassade.

Die Überschrift verspricht „original songs, covers, and mashups from a single prompt“ hinter „a simple REST API“, und die einzige Aktion auf der Seite ist die Anmeldung mit dem Google-Konto, das mit Ihrem Suno-Konto verknüpft ist, oder mit einem per E-Mail gesendeten Code. Weitere Links sind suno.com, Terms und Privacy, sonst nichts; /docs und /pricing auf derselben Domain zeigen dasselbe Anmeldefeld (geprüft am 17. Oktober 2026). Die API existiert, aber Dokumentation und Preise sind erst nach der Anmeldung sichtbar.

Der Partneraufruf ist durch Music Business Worldwide bekannt: Am 2. Juli 2026 berichtete das Magazin, Sunos Produktchef (CPO) Jack Brody habe die Pläne am 1. Juli in einem LinkedIn-Beitrag angekündigt und ein Bewerbungsformular verlinkt. Der Bericht zitiert das Formular mit den Worten: „We're beginning to explore a developer API, starting with a curated group of partners.“ Ein Startdatum wurde nicht genannt, und weder die Plattformseite noch die Release Notes noch Sunos Hilfe-Center ergänzen eines.

Unternehmen verweist Suno an den Vertrieb: In den Nutzungsbedingungen heißt es „if you are an enterprise user, you must contact sales to use our Service“. Derselbe Bericht hält fest, Suno habe „has not released self-serve developer access or published its own API documentation“, was zu dem passt, was die Seite im Oktober noch zeigt.

Drei Wege, Suno heute aus Code aufzurufen

Offizieller Partnerzugang. Das Formular, das Brody im Juli verlinkte, ist der einzige Weg, den Suno gezeigt hat, und der Bericht beschreibt frühen Zugang für eine ausgewählte Gruppe von Partnern statt einer offenen Registrierung. Am 17. Oktober 2026 trägt die Plattformseite nur das Anmeldefeld, ohne Formular, Warteliste oder Link zur Zugriffsanfrage, und wir fanden keinen öffentlichen Link zum Formular auf Sunos eigenen Seiten. Music Business Worldwide nannte keinen Zeitplan für einen breiteren Start.

Der inoffizielle GitHub-Wrapper. gcui-art/suno-api ist der bekannteste Behelf: 3.259 Sterne und rund 100 offene Issues am 17. Oktober 2026, der letzte Commit stammt vom 6. März 2026. Das README sagt, die offizielle API sei „is not yet available“, und verlangt drei Dinge: den Cookie Ihres eigenen Suno-Kontos, von Hand aus dem Netzwerk-Tab des Browsers kopiert; einen bezahlten 2Captcha-Schlüssel, weil Suno weiterhin hCaptcha-Aufgaben stellt; und einen echten Browser, gesteuert über Playwright mit rebrowser-Patches. Issue #262 vom 14. Dezember 2025 zitiert den Autor mit „lacks the time to maintain it“.

Sunos Nutzungsbedingungen, zuletzt geändert am 10. August 2026 und gültig ab 3. September 2026, verbieten „any data mining, robots, scraping, or similar data gathering or extraction methods“ und ebenso, Inhalte „through any means not intentionally made available or provided for through the Service“ zu beschaffen. Lesen Sie beide Klauseln in Sunos Nutzungsbedingungen, bevor Sie ein Produkt auf einen Wrapper bauen, der suno.com mit Ihrem eigenen Cookie steuert. Das README enthält keinen Hinweis darauf; seine einzige rechtliche Zeile ist die LGPL-3.0-Lizenz.

Eine Drittanbieter-API-Plattform. OmniaKey ist eine Drittanbieter-API-Plattform, nicht Suno. Sie verkauft API-Zugang zu Suno v4.5 und Suno v6 über ihre eigene asynchrone Media-API, mit einem Schlüssel, den OmniaKey ausgibt und abrechnet. Die Dokumentation listet genau zwei Modell-IDs, suno-v4.5 und suno-v6, und jede Anfrage liefert einen fertig gemischten Song, während ein Suno-Konto zwei Alternativen zeigt. Diesen Weg haben wir unten von Anfang bis Ende ausgeführt.

Einen Song in Python erzeugen

Eine Anfrage legt eine Aufgabe an, ein zweiter Aufruf prüft den Status, und die fertige MP3 kommt als signierter Link. Exportieren Sie Ihren Schlüssel, speichern Sie das Skript als suno_song.py und führen Sie es aus; das Skript fragt alle 5 Sekunden status ab, weil progress.percent nur ein Richtwert ist und während der Aufgabe bei 0 stehen kann.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Aufgabe anlegen. Denselben Idempotency-Key nur beim Wiederholen genau dieser Anfrage verwenden.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Nicht progress.percent, sondern status abfragen, bis die Aufgabe fertig ist.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Die MP3 jetzt herunterladen: Die signierte URL läuft in etwa einer Stunde ab.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Wir haben genau dieses Skript am 17. Oktober 2026 ausgeführt, und es gab zwei Zeilen aus.

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

Vom Start bis zur gespeicherten Datei vergingen 82 Sekunden. Die Datei ist eine Stereo-MP3 mit 48 kHz und etwa 161 kbps, 2:55 lang und 3,5 MB, und sie ist instrumental, weil das Skript instrumental auf true setzt.

Um die beiden Modelle in beiden Eingabemodi zu vergleichen, haben wir am 17. Oktober 2026 ab 13:03 UTC außerdem vier Songs über OmniaKeys API erzeugt und alle 4 Sekunden abgefragt.

Alle vier waren beim ersten Versuch fertig, und jede Anfrage lieferte eine MP3. Eine Beschreibung ergab einen vollständigen Song von etwa drei Minuten; derselbe Stil mit acht Zeilen eigenem Text kam nach 45 bis 63 Sekunden zurück, planen Sie also einen kurzen Track ein, wenn Sie den Text selbst schreiben. Die Bitraten lagen bei 151 bis 195 kbps in 48 kHz Stereo, und die signierten Download-Links verfielen etwa eine Stunde nach dem Anlegen der Aufgabe.

Parameter und Grenzen

• Ein nicht leeres input.lyrics wechselt in den Modus mit eigenem Text, in dem input.prompt, parameters.style oder parameters.tags den Stil beschreiben; eine Aufgabe ohne Prompt und ohne Text wird abgelehnt.
• suno-v6 wird über die Modell-ID gewählt und braucht kein mv, während mv nur für v4.5 gilt.
• Ausgeführt wird nur generate. Verlängern, reine Textgenerierung und Sprachsynthese scheitern mit 503 no_available_channel, und die Vorabbelastung wird zurückerstattet.
• Eine Anfrage ist ein fertiger Song, deshalb muss parameters.n 1 sein.
• Dateilinks sind signiert und kurzlebig, etwa eine Stunde, und Aufgabendatensätze werden 24 Stunden nach dem Anlegen aufbewahrt.

Fehler und Rückerstattungen

Aufgaben, die scheitern, abgebrochen werden oder den Anbieter nie erreichen, werden automatisch erstattet, und eine abgebrochene Aufgabe, die trotzdem fertig wird, wird nach dem Zustand abgerechnet, in dem sie endet. Wenn Sie denselben Idempotenzschlüssel mit demselben Body erneut senden, erhalten Sie die ursprüngliche Aufgabe mit 200 zurück, statt dass eine zweite angelegt wird; ein Wiederholungsversuch nach einem Timeout wird also nur einmal berechnet. Die Wiederherstellung ist kurz: Läuft die Anlage in einen Timeout, senden Sie denselben Body und denselben Schlüssel erneut; sobald Sie eine Aufgaben-ID haben, fragen Sie sie weiter ab.

Häufige Fragen

Gibt es eine kostenlose Suno-API?

Suno veröffentlicht auf platform.suno.com keine kostenlose API-Stufe. Die kostenlosen Pläne liegen in der suno.com-App: v6-mini ist für alle offen, und die Variante v4.5-all ist seit dem 21. Oktober 2025 kostenlos. Was in der kostenlosen Stufe entsteht, ist nur für den persönlichen, nicht kommerziellen Gebrauch.

Darf ich Songs aus einer Suno-API kommerziell nutzen?

Sunos Nutzungsbedingungen übertragen die Rechte am Output an Pro- und Premier-Abonnenten und erlauben die kommerzielle Nutzung nur für Output, der „downloaded by you through an approved channel“ wurde. Output aus der kostenlosen Stufe bleibt nicht kommerziell, und Remixe sind unabhängig vom Plan nur für den persönlichen Gebrauch. Songs aus einer Drittanbieter-API sind keine Ausnahme, lesen Sie also Sunos Nutzungsbedingungen, bevor Sie einen erzeugten Song in ein bezahltes Produkt aufnehmen.

Wie lange dauert ein Song?

Die Audio-Dokumentation nennt zwanzig Sekunden bis zwei Minuten pro Generierung. Unsere vier Aufgaben brauchten 70 bis 105 Sekunden, und der Skriptlauf brauchte 82 Sekunden vom Start bis zur gespeicherten Datei.

v4.5 oder v6?

Suno kündigte die v6-Familie am 9. September 2026 an und v4.5 am 1. Mai 2025. v6 wird allein über die Modell-ID gewählt, während v4.5 mit parameters.mv eine Version fixiert, und OmniaKeys ID suno-v4.5 sagt nicht, welcher v4.5-Variante sie entspricht. Suno nennt v6 sein Flaggschiffmodell. Beginnen Sie also mit Suno v6, solange Sie keine ältere v4.5-Version fixieren müssen.

Wie bekomme ich einen Suno-API-Schlüssel?

Wenn Sie bereits ein API-Konto haben, melden Sie sich bei platform.suno.com mit dem Google-Konto an, das mit Ihrem Suno-Konto verknüpft ist, oder mit einem per E-Mail gesendeten Code. Ohne Konto war das Partnerformular aus Juli der einzige öffentliche Zugang, und heute steht es nicht auf der Seite. Eine Drittanbieter-Plattform wie OmniaKey gibt einen eigenen Schlüssel aus, getrennt von jeder Suno-Anmeldung.