ACE-Step
Disponible en la APIace-step$0.0156/min de audio
- Entrada → salida
- Prompt de textoAudio
- Duraciones
- 10–240 s
ACE-Step
ACE Studio & StepFun
Entrada
promptEstilo, ambiente, instrumentos y tempo.instrumentalCon voz cantada, con tu letra o con una escrita por ti.Sin coste extralyricsSe canta tal cual; déjalo vacío y se escribe una letra por ti.duration30 s30 s30 s
Precios de la API de ACE-Step
Cada nivel que vendemos, junto al precio oficial del fabricante del modelo.
| Nivel | Opennan | Oficial |
|---|---|---|
| Por minuto de audio | $0.0156 | Sin precio oficial |
El fabricante no vende este modelo exacto en su propia API (pesos abiertos o retirado allí), así que no hay precio oficial con el que comparar.
Llama a ACE-Step desde tu código
Todo lo que necesitas para tu primera llamada está en esta página: el endpoint, una clave, la solicitud y cada parámetro.
https:/Consigue 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/music/generations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"ace-step","prompt":"Lo-fi hip hop cálido, piano suave, crepitar de vinilo, tempo relajado","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"Consulta la tarea
La llamada responde al instante con un id de tarea. Consulta la tarea hasta que termine:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Esperando un worker
- running
- En proceso
- succeeded
- Listo: outputs[].url contiene los archivos
- failed
- Falló: no se cobra
Parámetros
Generados desde el catálogo en vivo: cada valor que aparece aquí lo acepta la API.
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:/Funciona 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_music
- Argumentos de ejemplo
{ "model": "ace-step", "prompt": "Lo-fi hip hop cálido, piano suave, crepitar de vinilo, tempo relajado", "duration": 30 }
Preguntas sobre la API de ACE-Step
¿Cuánto cuesta la API de ACE-Step?
API de ACE-Step en Opennan: $0.0156 por minuto de audio. Los precios son en dólares estadounidenses por llamada, se muestran antes de ejecutar y todos los niveles están en la tabla de precios.
¿Qué entradas acepta ACE-Step?
Prompt de texto.
¿Qué opciones puede indicar una llamada?
Pistas de 10 a 240 segundos.
¿Cómo se factura?
Por segundo de audio generado, con precio por minuto.
¿Qué pasa si una generación falla?
Una tarea fallida se reembolsa por completo. Solo pagas por los resultados.
¿Cómo llamo a ACE-Step desde un agente de IA?
Añade el servidor MCP https://api.opennan.com/v1/mcp con tu clave de API como token bearer y llama a la herramienta generate_music con model "ace-step". O envía un POST a https://api.opennan.com/v1/music/generations.
Modelos similares
Modelos de Música que puedes llamar con la misma clave.