Sound effects
DisponibleDescribe 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.
Cómo funciona
- 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.
Llama a Sound effects desde tu código
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/ / api.opennan.com/ v1/ audio/ sound-effectsConsigue una clave de API
Crea una clave en la consola. Usa el mismo saldo que el playground.
Crear una claveEnvía tu primera solicitud
La misma solicitud que envía el playground. Pon tu clave en OPENNAN_KEY.
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.mp3Lee el resultado
El resultado llega en la misma respuesta. La cabecera X-Usage-Cost-Usd indica lo que costó la llamada.
Errores y cómo resolverlos
401Falta la clave o es incorrecta
Envía la cabecera Authorization: Bearer con una clave de la consola.
402Saldo insuficiente
Añade saldo en Facturación y vuelve a enviar la misma llamada.
400Un valor no se acepta
Lee error.message: indica el campo. Usa un valor de la tabla de parámetros.
429Demasiadas solicitudes
Espera unos segundos y vuelve a intentarlo, esperando más tras cada 429.
Añade Opennan a tu app de IA
Una sola instalación le da a tu IA todas las herramientas de Opennan: vídeo, imágenes, chat, voz, música, efectos de sonido, 3D, subtítulos y doblaje. Elige tu app y sigue los pasos.
https:/ / api.opennan.com/ v1/ mcpFunciona en Codex CLI, la app de Codex y la extensión de Codex para el IDE: comparten ~/.codex/config.toml. Si la app o el IDE no ven OPENNAN_KEY, usa la opción de config.toml con tu clave. Codex pide permiso antes de cada herramienta: apruébalo para seguir.
Consigue una clave de API
Crea una clave en la consola. Empieza por sk- y usa el mismo saldo que la web.
Crear una claveGuarda tu clave como 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-..."Instala el plugin de Opennan: el servidor y una skill que enseña a tu IA a elegir modelos, confirmar precios y esperar los resultados
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanO añade solo el servidor
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYO añade esto a ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Comprueba que opennan aparece en la lista
codex mcp listReinicia Codex y pide lo que quieras
“Haz un vídeo de 5 segundos de lluvia en una calle de neón, una canción que lo acompañe y una imagen de póster.”
Cambia sk-... por tu propia clave y mantenla en privado: quien la tenga puede gastar tu saldo. Tu app puede listar las herramientas sin clave; para crear algo necesitas una.
Úsalo desde un agente de IA
Añade el servidor MCP de Opennan a tu agente y llama a esta herramienta.
- Herramienta
- generate_sfx
- Argumentos de ejemplo
{ "text": "heavy rain on a tin roof with distant thunder", "duration_seconds": 5 }
Sound effects: preguntas
¿Cuánto cuesta Sound effects?
$0.0026 per second. The Run button shows the exact price for your input before you start.
¿Cómo lo llamo desde mi código?
Envía POST https://api.opennan.com/v1/audio/sound-effects con tu clave de API. El resultado llega en la misma respuesta.
¿Puede usarlo mi agente de IA?
Sí. Añade el servidor MCP https://api.opennan.com/v1/mcp y llama a la herramienta generate_sfx, o indícale a tu agente https://api.opennan.com/llms.txt.
¿Qué pasa si una ejecución falla?
Una ejecución fallida no se cobra. Solo pagas por resultados.