API para desarrolladores

Flixly AI API

Crea con más de 50 modelos de IA: una API y un sistema de créditos. Genera imágenes, vídeos, audio y objetos 3D en minutos.

Inicio rápido

Empieza a generar en tres líneas de código. Elige tu lenguaje:

curl https://www.flixly.ai/api/v1/generate \
  -H "Authorization: Bearer flx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-dev",
    "prompt": "A cat wearing a top hat, oil painting",
    "type": "TEXT_TO_IMAGE"
  }'

Referencia de endpoints

Todos los endpoints llevan el prefijo https://www.flixly.ai. Haz clic en un endpoint para desplegar los ejemplos.

Autenticación

Todas las peticiones a la API requieren un token Bearer en la cabecera Authorization de cada petición.

Cómo obtener tu clave de API

Inicia sesión en Flixly en www.flixly.ai/auth/login
Ve a Panel → Ajustes → Claves de API
Haz clic en «Create API Key» y dale un nombre
Copia la clave (empieza por flx_live_): solo se muestra una vez

Cómo usar tu clave

# Inclúyela en la cabecera de cada petición
Authorization: Bearer flx_live_YOUR_KEY

Mantén tu clave de API en secreto. No la expongas en código de cliente ni en repositorios públicos.

Límites de peticiones

Los límites crecen con tu plan. Puedes mejorarlo cuando quieras desde la página de facturación.

Plan	Peticiones / min	Tareas en paralelo
Free	10	1
Lite	30	2
Pro	60 – 200	3 – 25

Cuando superas tu límite de peticiones recibes una respuesta 429 con una cabecera Retry-After que indica cuántos segundos debes esperar.

Códigos de error

Todos los errores siguen la misma estructura JSON:

{
  "error": {
    "code": "insufficient_credits",
    "status": 402,
    "message": "You need at least 10 credits for this model."
  }
}

Código	Estado	Descripción
`unauthorized`	401	Clave de API no válida o ausente.
`insufficient_credits`	402	No hay créditos suficientes para completar la petición.
`forbidden`	403	La clave de API no tiene permiso para esta acción.
`not_found`	404	El recurso solicitado no existe.
`validation_error`	422	El cuerpo de la petición no ha superado la validación. Revisa los campos obligatorios.
`rate_limit_exceeded`	429	Demasiadas peticiones. Reinténtalo pasado el periodo indicado en las cabeceras.
`internal_error`	500	Error inesperado del servidor. Contacta con soporte si persiste.

¿Listo para empezar?

Crea una cuenta gratuita, consigue una clave de API y empieza a generar en menos de un minuto.