FlyAIgh

Desarrolladores · MCP

Genera imágenes y vídeos desde tu agente de IA

El servidor MCP de FlyAIgh permite a Claude Code, Codex, Cursor y otros clientes MCP usar todos los modelos de imagen y vídeo de FlyAIgh: consultar precios, generar, usar tus propios archivos de referencia y descargar los resultados, todo con un mismo saldo de créditos.

Requiere una suscripción Basic o superior.

Endpoint

URL
https://www.flyaigh.com/api/mcp
Transporte
Streamable HTTP (sin estado)
Autenticación
Authorization: Bearer <tu clave de API>

Configúralo en tres pasos

  1. 1

    Suscríbete a Basic o superior

    La API está incluida en todas las suscripciones de pago desde Basic, mensuales o anuales. Los créditos que gastas con la API salen del mismo saldo que en la web.

  2. 2

    Crea una clave de API

    Abre Herramientas → MCP, ponle nombre y cópiala. Empieza por fa_live_, solo se muestra una vez y puedes revocarla cuando quieras.

  3. 3

    Añade FlyAIgh a tu agente

    Pega una de las configuraciones de abajo y pídele a tu agente una imagen o un vídeo con tus propias palabras.

Conecta tu cliente

Sustituye fa_live_your_key por tu clave. No la guardes en archivos compartidos ni en repositorios.

Claude Code

claude mcp add --transport http flyaigh https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

Codex · ~/.codex/config.toml

[mcp_servers.flyaigh]
url = "https://www.flyaigh.com/api/mcp"
bearer_token_env_var = "FLYAIGH_API_KEY"

Después define la clave en tu terminal: export FLYAIGH_API_KEY=fa_live_your_key

Cursor · ~/.cursor/mcp.json

{
  "mcpServers": {
    "flyaigh": {
      "url": "https://www.flyaigh.com/api/mcp",
      "headers": { "Authorization": "Bearer fa_live_your_key" }
    }
  }
}

Otros clientes (solo stdio)

npx -y mcp-remote https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

Para clientes que solo pueden lanzar un comando local, mcp-remote hace de puente con el endpoint HTTP.

Herramientas

Los agentes ven ocho herramientas. Dos gastan créditos; las demás solo leen.

list_models
Modelos de imagen o vídeo con sus modos, duraciones, resoluciones, formatos, límites de referencias y un precio de ejemplo.
quote
Los créditos exactos que costaría una petición, con las mismas comprobaciones y el mismo precio que la llamada real. No se cobra nada.
generate_image
Crea una imagen a partir de texto o edita y sigue tus imágenes de referencia. Gasta créditos.
generate_video
Crea un vídeo a partir de texto, un primer fotograma, primer y último fotograma, o imágenes, vídeos y audio de referencia. Gasta créditos.
get_job
Estado de un trabajo. Al terminar, un enlace de descarga; los trabajos fallidos se reembolsan automáticamente.
list_my_generations
Tus generaciones recientes, para reutilizarlas como referencia o descargarlas de nuevo.
upload_file
Sube tu propia imagen, vídeo o audio y obtén un id de archivo para usarlo como referencia.
get_balance
Créditos restantes, tu plan y lo que esta clave ha gastado hoy y este mes.

Qué pedirle

Usa FlyAIgh para hacer un vídeo de 5 segundos en 9:16 de un barco de papel que flota por una calle lluviosa de noche. Enséñame primero el precio, luego genéralo y guarda el archivo en ./out.

Un buen agente llama a quote, te pide confirmación, genera con expected_credits y un idempotency_key, y consulta get_job hasta que el archivo está listo.

Precios y límites

  • Los mismos créditos que en la web para el mismo modelo y ajustes. Sin recargo por usar la API y sin factura aparte.
  • El gasto lo limita tu saldo de créditos. También puedes poner a una clave su propio límite diario en la página MCP; por defecto no tiene. Lo que gastó cada clave, día a día, aparece en la misma página.
  • Si el precio cambia entre quote y la generación, no se cobra nada y se devuelve el precio nuevo (expected_credits).
  • Cada clave puede enviar 10 trabajos por minuto, así un bucle descontrolado se detiene rápido. Reintentar con el mismo idempotency_key en 24 horas nunca cobra dos veces.
  • Subidas: imágenes hasta 25 MB, vídeos hasta 200 MB, audio hasta 30 MB; subidas en base64 hasta 3 MB. Solo puedes usar como referencia tus propios archivos y generaciones.
  • Los trabajos fallidos se reembolsan automáticamente. Los originales privados se devuelven como enlaces firmados que caducan en una hora.

Preguntas

¿Qué plan necesito para la API de FlyAIgh?

Cualquier suscripción desde Basic, mensual o anual. Las cuentas gratuitas y las que solo compraron el pack de prueba o un paquete de créditos no pueden crear claves. Si tu suscripción termina, tus claves se pausan y vuelven a funcionar cuando te suscribes.

¿Cómo se cobra el uso de la API?

En créditos, del mismo saldo que usas en la web y al mismo precio para el mismo modelo y ajustes. Llama a quote para ver el precio exacto antes de generar. Usar la API no tiene coste adicional.

¿Qué modelos puede usar mi agente?

Todos los modelos de imagen y vídeo de FlyAIgh. La herramienta list_models devuelve la lista actual con los modos, duraciones, resoluciones y un precio de ejemplo de cada modelo, así el agente ve siempre lo mismo que ofrece la web.

¿Puedo usar mis propias imágenes, vídeos o audio?

Sí. upload_file da a tu agente un enlace de subida (o acepta un archivo pequeño en línea) y devuelve un id de archivo para usarlo como primer fotograma o referencia. También sirven tus generaciones anteriores de la biblioteca.

¿Está segura mi clave de API?

Solo guardamos un hash de la clave, se te muestra una vez y puedes revocarla en la página MCP cuando quieras; las claves revocadas dejan de funcionar al instante. Trátala como una contraseña: guárdala en una variable de entorno, no en un archivo compartido.

¿Funciona con ChatGPT o con las apps de Claude?

Por ahora el servidor usa claves de API, que admiten agentes de programación como Claude Code, Codex y Cursor. Los conectores de un clic para las apps de ChatGPT y Claude requieren inicio de sesión OAuth, que está previsto.

Lleva los modelos a tu flujo de trabajo

Crea una clave, añade una línea a tu agente y genera imágenes y vídeos sin salir de tu editor ni de la terminal.

Crear una clave de API