Sound effects
LiveDescribe a sound. Get it back as audio in the same response: footsteps on gravel, heavy rain, a door slam, a whoosh, up to 22 seconds long.
So funktioniert’s
- 01Describe the soundWhat it is and how it should feel, up to 1,000 characters.
- 02We make itOne sound, as long as you ask for.
- 03Get the audioMP3, WAV or Opus, in the same response.
Sound effects aus deinem Code aufrufen
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/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/audio/sound-effects \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"text":"heavy rain on a tin roof with distant thunder","duration_seconds":5}' \ --output sound.mp3Ergebnis lesen
Das Ergebnis kommt in derselben Antwort. Der Header X-Usage-Cost-Usd nennt die Kosten des Aufrufs.
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:/Funktioniert 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_sfx
- Beispielargumente
{ "text": "heavy rain on a tin roof with distant thunder", "duration_seconds": 5 }
Sound effects: Fragen
Was kostet Sound effects?
$0.0026 per second. The Run button shows the exact price for your input before you start.
Wie rufe ich es aus meinem Code auf?
Sende POST https://api.opennan.com/v1/audio/sound-effects mit deinem API-Schlüssel. Das Ergebnis kommt in derselben Antwort.
Kann mein KI-Agent es nutzen?
Ja. Füge den MCP-Server https://api.opennan.com/v1/mcp hinzu und rufe das Tool generate_sfx 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.