Musik-Generierungs-API
LiveEigene Hintergrundmusik und Scores für deine Videos.
Eingabe
promptStil, Stimmung, Instrumente und Tempo.instrumentalMit Gesang, nach deinem Text oder einem für dich geschriebenen.Ohne AufpreislyricsWird so gesungen, wie geschrieben; leer lassen, dann wird ein Text für dich geschrieben.duration30 s30 s30 s
Musik-Generierungs-API: Modelle vergleichen
Alle Modelle hinter diesem Endpoint, mit Live-Preisen. Teste eins im Playground oder öffne seine Seite.
- CassetteAI Sound EffectsCassetteAI$0.013 pro TrackAm günstigsten
- ACE-StepACE Studio & StepFun$0.0156 pro Minute Audio
- CassetteAI MusicCassetteAI$0.026 pro Minute Audio (je angefangene Minute abgerechnet)
- Stable Audio 3 Small SFXStability AI$0.02678 pro Track
- Stable Audio 3 SmallStability AI$0.02821 pro Track
- Stable Audio 3Stability AI$0.04888 pro Track$0.08 pro Track-38 %
Musik-Generierungs-API aus deinem Code aufrufen
Ein Endpoint für jedes Modell oben. Zum Wechseln änderst du das Feld model.
https:/ / api.opennan.com/ v1/ music/ generations- GET
/Alle Modelle dieses Endpoints, mit Preisenv1/ models? category= music
API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er nutzt dasselbe Guthaben wie der Playground.
Schlüssel erstellenErste Anfrage senden
Dieselbe Anfrage, die der Playground sendet. Setze OPENNAN_KEY auf deinen Schlüssel.
curl https://api.opennan.com/v1/music/generations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"ace-step","prompt":"Warmer Lo-Fi-Hip-Hop, sanftes Klavier, Vinylknistern, entspanntes Tempo","duration":30,"instrumental":true}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Task abfragen
Der Aufruf antwortet sofort mit einer Task-ID. Frag den Task ab, bis er fertig ist:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Wartet auf einen Worker
- running
- Wird erstellt
- succeeded
- Fertig: outputs[].url enthält die Dateien
- failed
- Fehlgeschlagen: wird nicht berechnet
Parameter
Aus dem Live-Katalog erzeugt: Jeder Wert hier wird von der API akzeptiert.
Fehler und wie du sie behebst
401Schlüssel fehlt oder ist falsch
Sende den Header Authorization: Bearer mit einem Schlüssel aus der Konsole.
402Guthaben zu niedrig
Lade unter Abrechnung Guthaben auf und sende denselben Aufruf erneut.
400Ein Wert wird nicht akzeptiert
Lies error.message: Dort steht das Feld. Nimm einen Wert aus der Parametertabelle.
429Zu viele Anfragen
Warte ein paar Sekunden und versuche es erneut, nach jedem 429 etwas länger.
Opennan zu deiner KI-App hinzufügen
Eine Installation gibt deiner KI jedes Opennan-Tool: Video, Bilder, Chat, Stimme, Musik, Soundeffekte, 3D, Untertitel und Synchronisation. Wähle deine App und folge den Schritten.
https:/ / api.opennan.com/ v1/ mcpFunktioniert in der Codex CLI, der Codex-App und der Codex-IDE-Erweiterung: Sie teilen ~/.codex/config.toml. Sieht die App oder IDE OPENNAN_KEY nicht, nimm die config.toml-Variante mit deinem Schlüssel. Codex fragt vor jedem Tool-Aufruf: Bestätige, um weiterzumachen.
API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er beginnt mit sk- und nutzt dasselbe Guthaben wie die Website.
Schlüssel erstellenSpeichere deinen Schlüssel als OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Installiere das Opennan-Plugin: der Server plus ein Skill, der deiner KI beibringt, Modelle zu wählen, Preise zu bestätigen und auf Ergebnisse zu warten
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOder füge nur den Server hinzu
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOder füge das in ~/.codex/config.toml ein
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Prüfe, ob opennan aufgelistet ist
codex mcp listStarte Codex neu und frag nach allem, was du willst
“Mach ein 5-Sekunden-Video von Regen auf einer Neonstraße, einen passenden Song und ein Posterbild.”
Ersetze sk-... durch deinen eigenen Schlüssel und halte ihn geheim: Wer ihn hat, kann dein Guthaben ausgeben. Deine App kann die Tools ohne Schlüssel auflisten; zum Erstellen brauchst du einen.
Aus einem KI-Agenten nutzen
Füge deinem Agenten den Opennan-MCP-Server hinzu und rufe dieses Tool auf.
- Tool
- generate_music
- Beispielargumente
{ "model": "ace-step", "prompt": "Warmer Lo-Fi-Hip-Hop, sanftes Klavier, Vinylknistern, entspanntes Tempo", "duration": 30 }
Musik-Generierungs-API: Fragen
Was kostet Musik-Generierungs-API?
Ab $0.0156 pro Minute Audio mit ACE-Step, dem günstigsten von 4 Modellen hier. Du siehst den Preis vor dem Start.
Wie rufe ich es aus meinem Code auf?
Sende POST https://api.opennan.com/v1/music/generations mit deinem API-Schlüssel. Die Antwort ist eine Task-ID: Frag https://api.opennan.com/v1/tasks/{id} ab, bis der Task fertig oder fehlgeschlagen ist.
Kann ich Modelle wechseln, ohne meinen Code zu ändern?
Ja. Ändere das Feld model und behalte den Rest der Anfrage, denselben Schlüssel und dasselbe Guthaben.
Kann mein KI-Agent es nutzen?
Ja. Füge den MCP-Server https://api.opennan.com/v1/mcp hinzu und rufe das Tool generate_music auf, oder verweise deinen Agenten auf https://api.opennan.com/llms.txt.
Was passiert, wenn ein Durchlauf fehlschlägt?
Ein fehlgeschlagener Durchlauf wird nicht berechnet. Du zahlst nur für Ergebnisse.