FlyAIgh

Desenvolvedores · MCP

Gere imagens e vídeos direto do seu agente de IA

O servidor MCP do FlyAIgh permite que o Claude Code, Codex, Cursor e outros clientes MCP usem todos os modelos de imagem e vídeo do FlyAIgh: consultar preços, gerar, usar seus próprios arquivos de referência e baixar os resultados — tudo com um único saldo de créditos.

Criar uma chave de APIVer planos

Exige uma assinatura Basic ou superior.

Endpoint

URL
https://www.flyaigh.com/api/mcp
Transporte
Streamable HTTP (sem estado)
Autenticação
Authorization: Bearer <sua chave de API>

Configure em três passos

  1. 1

    Assine o Basic ou superior

    A API faz parte de todas as assinaturas pagas a partir do Basic, mensais ou anuais. Os créditos gastos pela API saem do mesmo saldo do site.

  2. 2

    Crie uma chave de API

    Abra Ferramentas → MCP, dê um nome à chave e copie. Ela começa com fa_live_, aparece só uma vez e pode ser revogada quando você quiser.

  3. 3

    Adicione o FlyAIgh ao seu agente

    Cole uma das configurações abaixo e peça uma imagem ou um vídeo ao seu agente com suas próprias palavras.

Conecte seu cliente

Troque fa_live_your_key pela sua chave. Não guarde a chave em arquivos compartilhados nem em repositórios.

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"

Depois defina a chave no 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" }
    }
  }
}

Outros clientes (somente stdio)

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

Para clientes que só iniciam um comando local, o mcp-remote faz a ponte com o endpoint HTTP.

Ferramentas

O agente vê oito ferramentas. Duas gastam créditos; as outras só leem.

list_models
Modelos de imagem ou vídeo com modos, durações, resoluções, proporções, limites de referência e um preço de exemplo.
quote
Os créditos exatos de um pedido, com as mesmas verificações e o mesmo preço da chamada real. Nada é cobrado.
generate_image
Gera uma imagem a partir de texto ou edita e segue suas imagens de referência. Gasta créditos.
generate_video
Gera um vídeo a partir de texto, primeiro quadro, primeiro e último quadros, ou imagens, vídeos e áudio de referência. Gasta créditos.
get_job
Status de uma tarefa. Quando termina, um link de download; tarefas com falha são reembolsadas automaticamente.
list_my_generations
Suas gerações recentes, para reutilizar como referência ou baixar de novo.
upload_file
Envie sua própria imagem, vídeo ou áudio e receba um id de arquivo para usar como referência.
get_balance
Créditos restantes, seu plano e quanto esta chave gastou hoje e neste mês.

O que pedir

Use o FlyAIgh para fazer um vídeo de 5 segundos em 9:16 de um barquinho de papel descendo uma rua chuvosa à noite. Mostre o preço primeiro, depois gere e salve o arquivo em ./out.

Um bom agente chama quote, pede sua confirmação, gera com expected_credits e um idempotency_key e consulta get_job até o arquivo ficar pronto.

Preços e limites

  • Os mesmos créditos do site para o mesmo modelo e configurações. Sem taxa extra pela API e sem fatura separada.
  • O gasto é limitado pelo seu saldo de créditos. Você também pode dar a uma chave um limite diário próprio na página MCP; por padrão não há. O gasto de cada chave, dia a dia, aparece na mesma página.
  • Se o preço mudar entre o quote e a geração, nada é cobrado e o novo preço é devolvido (expected_credits).
  • Cada chave pode enviar 10 tarefas por minuto, então um loop descontrolado para logo. Repetir com o mesmo idempotency_key em até 24 horas nunca cobra duas vezes.
  • Envios: imagens até 25 MB, vídeos até 200 MB, áudio até 30 MB; envios em base64 até 3 MB. Só seus próprios arquivos e gerações podem ser usados como referência.
  • Tarefas com falha são reembolsadas automaticamente. Originais privados voltam como links assinados que expiram em uma hora.

Perguntas

Qual plano eu preciso para a API do FlyAIgh?

Qualquer assinatura a partir do Basic, mensal ou anual. Contas gratuitas e contas que só compraram o pacote de teste ou um pacote de créditos não podem criar chaves. Se a assinatura acabar, as chaves ficam pausadas e voltam a funcionar quando você assinar de novo.

Como o uso da API é cobrado?

Em créditos, do mesmo saldo que você usa no site e pelo mesmo preço para o mesmo modelo e configurações. Chame quote para ver o preço exato antes de gerar. Não há custo extra para usar a API.

Quais modelos meu agente pode usar?

Todos os modelos de imagem e vídeo do FlyAIgh. A ferramenta list_models devolve a lista atual com modos, durações, resoluções e um preço de exemplo de cada modelo, então o agente sempre vê o mesmo que o site oferece.

Posso usar minhas próprias imagens, vídeos ou áudio?

Sim. O upload_file dá ao seu agente um link de envio (ou aceita um arquivo pequeno direto) e devolve um id para usar como primeiro quadro ou referência. Suas gerações anteriores da biblioteca também servem.

Minha chave de API está segura?

Guardamos só um hash da chave, ela é mostrada uma única vez e você pode revogá-la na página MCP quando quiser; chaves revogadas param na hora. Trate a chave como uma senha: guarde em uma variável de ambiente, não em um arquivo compartilhado.

Funciona com o ChatGPT ou com os apps do Claude?

Por enquanto o servidor usa chaves de API, compatíveis com agentes de programação como Claude Code, Codex e Cursor. Conectores de um clique para os apps do ChatGPT e do Claude exigem login OAuth, que está planejado.

Leve os modelos para o seu fluxo de trabalho

Crie uma chave, adicione uma linha ao seu agente e gere imagens e vídeos sem sair do editor ou do terminal.

Criar uma chave de API