API v1

Documentación de FM9 API

Construye potentes funciones de generación musical en tus aplicaciones con nuestra REST API.

Inicio Rápido

Genera tu primera pista con una sola llamada a la API.

Requestbash
curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "música electrónica de baile animada"}'
Responsejson
{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

Autenticación

Todas las solicitudes de API requieren una clave de API. Incluye tu clave en el encabezado Authorization:

Obtén tu clave de API desde el panel de desarrollador.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST/v1/generate

Generar Música

Crea una nueva tarea de generación de música.

Parameters

  • prompt-Descripción textual de la música a generar (requerido)
  • duration-Duración de la pista en segundos (30-180, predeterminado: 60)
  • style-Preset de estilo musical (opcional)
  • instrumental-Si generar solo instrumental (predeterminado: false)

Devuelve un objeto de generación con ID de tarea y estado.

GET/v1/generation/:id

Obtener Estado de Generación

Verifica el estado de una tarea de generación.

Devuelve el objeto de generación con el estado actual y URLs de descarga cuando esté completo.

GET/v1/generations

Listar Generaciones

Recupera una lista de tu historial de generación.

Parameters

  • limit-Número de resultados a devolver (predeterminado: 20, máx: 100)
  • offset-Desplazamiento de paginación (predeterminado: 0)
  • status-Filtrar por estado (pending, processing, completed, failed)

Precios de API

Precios simples y transparentes basados en uso.

Starter

Gratis

10 generaciones/mes

  • Acceso básico a API
  • Calidad estándar
  • Soporte comunitario

Developer

$49/mo

500 generaciones/mes

  • Acceso completo a API
  • Salida de alta calidad
  • Soporte prioritario
  • Callbacks Webhook

Enterprise

Personalizado

Ilimitado

  • Infraestructura dedicada
  • Modelos personalizados
  • Garantía SLA
  • Soporte 24/7

Límites de Velocidad

Para garantizar un uso justo y estabilidad del servicio, se aplican los siguientes límites:

  • Starter: 10 solicitudes/minuto
  • Developer: 60 solicitudes/minuto
  • Enterprise: Límites personalizados

Si excedes el límite, recibirás una respuesta 429 Too Many Requests.

Códigos de Error

La API usa códigos de respuesta HTTP estándar para indicar éxito o fallo.

CodeDescription
400Bad Request - Parámetros inválidos
401Unauthorized - Clave de API inválida o faltante
402Payment Required - Créditos insuficientes
429Too Many Requests - Límite de velocidad excedido
500Internal Server Error - Algo salió mal de nuestro lado

¿Necesitas Ayuda?

Nuestro equipo de soporte para desarrolladores está aquí para ayudar.

Email: [email protected]

Documentación completa disponible en docs.fm9.ai