· reAPI Team
Mureka api tutorial
Mureka API en reAPI recibe letras y un estilo opcional: devuelve un ID de tarea y, al terminar, URL de canciones. Sigue el flujo documentado de envío y consulta.

Una solicitud de Mureka API en reAPI necesita el modelo mureka-v9-song y la letra en lyrics. El flujo documentado devuelve primero un ID de tarea y, al terminar, las URL de las canciones. Admite hasta 3 canciones por solicitud y salida en mp3, wav o flac.[1]
Este tutorial cubre esa interfaz concreta de reAPI, según la documentación pública y la implementación revisadas el 22 de octubre de 2026. No se enviaron los ejemplos para generar audio. Sirven para explicar la solicitud y el tratamiento del resultado; no demuestran velocidad, calidad musical, fidelidad a referencias ni que sea el modelo más reciente de Mureka. La portada es una ilustración conceptual, no un resultado de generación de audio.
Puntos clave
- Coloca las palabras que se cantarán en
lyricsy la dirección musical en el campo opcionalprompt.[1] - Empieza con
number_of_songs: 1. El rango documentado es 1–3 y la cantidad afecta al cargo.[1] - Tras enviar la solicitud, conserva el
idrecibido y consulta esa tarea hasta que termine.[2] - Lee
output.audio_urlsdespués decompletedy copia los archivos a tu almacenamiento si necesitas conservarlos.[2]
mureka api key
Las solicitudes siguientes se envían a reapi.ai y requieren una clave API de reAPI. En el panel de reAPI, abre API Keys, crea una clave y guárdala cuando aparezca. Envíala mediante Authorization: Bearer .... La guía de autenticación explica la creación de claves y los errores de autenticación.[3]
Mantén la clave en tu servidor o en un gestor de secretos. La variable de shell REAPI_API_KEY representa ese valor privado; el tutorial no proporciona una clave. No incluyas claves reales en JavaScript del navegador, capturas o repositorios públicos. Una cuenta o clave de otro servicio no sustituye a las credenciales emitidas por reAPI.
mureka api docs
La referencia de Mureka V9 Song distingue el texto que se cantará de las instrucciones musicales. lyrics es obligatorio y admite hasta 3000 caracteres. prompt es opcional, admite hasta 1024 caracteres y puede describir género, ambiente, instrumentos, tono vocal o tempo.[1]
Por ejemplo, coloca la estrofa y el estribillo en lyrics, y una indicación como «pop suave de piano con percusión contenida» en prompt. Son entradas ilustrativas, no una receta probada. Escribir las palabras solo en el prompt de estilo no cumple el requisito del campo de letra.
| Campo | Entrada documentada | Elección inicial |
|---|---|---|
model | mureka-v9-song | Usa el identificador exacto. |
lyrics | Obligatorio; hasta 3000 caracteres | Aporta tu propia letra. |
prompt | Opcional; hasta 1024 caracteres | Describe el estilo musical deseado. |
number_of_songs | Entero 1–3; predeterminado 1 | Usa 1 para pedir una canción. |
output_format | mp3, wav, flac; predeterminado mp3 | Elige el formato que necesite tu aplicación. |
reference_id, vocal_id, melody_id | ID de referencia existentes, opcionales | Omítelos si no tienes ID válidos. |
Los campos de referencia aceptan ID, no nombres de archivos locales, URL de audio ni descripciones libres. Este tutorial no proporciona un endpoint de subida ni un procedimiento para crear esos ID. Omítelos en el flujo básico de letra y estilo; añade uno solo si ya tienes una referencia válida para el campo correspondiente. La existencia de un control de referencia no demuestra cuánto lo seguirá una canción generada.[1]
Mureka api tutorial
Este ejemplo se basa en la documentación. La letra breve es solo ilustrativa. Sustitúyela por tu propio material y configura la clave en el servidor antes de decidir ejecutarlo. Enviar una solicitud de generación puede generar cargos.
curl https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer $REAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mureka-v9-song",
"lyrics": "Morning light across the floor\nI leave a note beside the door",
"prompt": "Soft piano pop with restrained percussion",
"number_of_songs": 1,
"output_format": "mp3"
}'Guarda el id devuelto por el POST junto con los ajustes enviados. Asígnalo a TASK_ID y consulta su estado con la misma autenticación:
curl "https://reapi.ai/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $REAPI_API_KEY"La respuesta de consulta determina el siguiente paso de la aplicación.[2]
status | Comportamiento de la aplicación |
|---|---|
processing | Mantener la tarea pendiente. Un ID no es un archivo de audio terminado. |
completed | Leer output.audio_urls y ofrecer al usuario los archivos devueltos. |
failed | Leer error y usage.credits; dejar de esperar un resultado exitoso. |
Que se agote el tiempo de consulta de tu aplicación no demuestra un fallo de generación. Conserva el ID para consultarlo de nuevo, en lugar de crear automáticamente otra solicitud. La referencia de tareas documenta las consultas y los errores. Ante HTTP 429, respeta Retry-After; no repitas la solicitud inmediatamente en un bucle sin pausa.
mureka api pricing
La unidad de facturación documentada es la canción generada. number_of_songs controla la cantidad; prompt, el formato y los campos de referencia opcionales no son dimensiones de precio independientes en el contrato documentado de este modelo.[1] Consulta la estimación actual en la página de Mureka V9 Song con la cantidad que quieres solicitar.
Consultar el estado no consume créditos. usage.credits es el resumen liquidado en créditos enteros, por lo que debes leerlo junto con status: un cero durante processing no es una oferta de generación gratuita. Una tarea fallida puede mostrar cero o un cargo retenido; no presupongas un reembolso completo en todos los fallos.[2] Un nuevo POST para otra variante es otra solicitud de generación, no una consulta de estado.
Mureka api download
Después de completed, procesa output.audio_urls como un array, incluso si pediste una sola canción. La salida documentada contiene una URL por canción generada, en el formato seleccionado. Si tu aplicación admite varias canciones, evita guardar únicamente el primer resultado sin avisar.[1]
Para archivar, descarga los archivos y guárdalos según tu propia política de conservación. El contrato de tareas no garantiza almacenamiento permanente de las URL de resultado.[2] Asocia el ID, los ajustes, el estado y las ubicaciones guardadas para distinguir una tarea pendiente de una canción terminada que todavía no se ha copiado.
En tu primera integración de Mureka API, empieza con la solicitud mínima anterior, gestiona los tres estados e inspecciona el audio real antes de usarlo en producción. La página del modelo ofrece la estimación actual y la referencia API el contrato completo de campos.
Consultas relacionadas sobre la API
mureka v9 api
Esta guía cubre mureka-v9-song en reAPI. El identificador delimita el ejemplo; no afirma que V9 sea la versión más reciente de Mureka.
mureka api documentation
La referencia enlazada de reAPI documenta este endpoint y estos campos. Otras interfaces pueden usar autenticación, rutas o parámetros distintos.
mureka api cost
Consulta la página del modelo con la cantidad elegida y revisa el cargo final en la liquidación de la tarea.
mureka api platform
Los ejemplos usan reAPI. Al configurar el cliente, comprueba juntos la URL base, el emisor de las credenciales y el esquema de solicitud.
Referencias
[1] Mureka V9 Song API. Revisado el 22 de octubre de 2026.
[2] Tareas. Revisado el 22 de octubre de 2026.
[3] Autenticación. Revisado el 22 de octubre de 2026.