Documentación de la API

Obtener y guardar una clave API

La autenticación debe estar en el servidor de tu aplicación. Nunca pongas una clave de producción en el navegador, una app móvil, los registros o un repositorio público.

1. 1Crea una cuenta y abre el área de claves API en el panel.
2. 2Copia la clave y guárdala en el gestor de secretos o el entorno protegido del servidor.
3. 3Envíala en el encabezado Authorization como token Bearer y cámbiala de inmediato si se expone.

Inicio rápido

Crea una tarea musical asíncrona, guarda el workId devuelto y consulta el endpoint feed hasta finalizar. La solicitud funciona después de configurar la clave del servidor.

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v6",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

Los archivos usan UDIOAPI_KEY, polling limitado y errores estructurados, sin dependencias externas. Elimina todos los secretos antes de publicar un fork en GitHub.

Endpoints de la API

Usa /v2/generate como endpoint predeterminado de Music Generate. MiniMax es un motor musical adicional disponible en /v2/minimax/generate, no el modelo predeterminado de generación musical.

Gestión de errores

Trata el estado HTTP y el cuerpo estructurado como parte del contrato de integración. Registra el workId y tu ID de solicitud, pero nunca la clave API.

No reintentes rechazos de moderación ni otros fallos finales. Muestra fail_message o error_message para que el usuario pueda cambiar la entrada.

Resumen de cambios

Los cambios de API relevantes para la compatibilidad se resumen aquí y enlazan al endpoint afectado.