FlyAIgh

Sviluppatori · MCP

Immagini e video direttamente dal tuo agente IA

Il server MCP di FlyAIgh permette a Claude Code, Codex, Cursor e agli altri client MCP di usare tutti i modelli di immagini e video di FlyAIgh: vedere i prezzi, generare, usare i tuoi file di riferimento e scaricare i risultati, tutto con un unico saldo crediti.

Richiede un abbonamento Basic o superiore.

Endpoint

URL
https://www.flyaigh.com/api/mcp
Trasporto
Streamable HTTP (senza stato)
Autenticazione
Authorization: Bearer <la tua chiave API>

Configurazione in tre passaggi

  1. 1

    Abbonati a Basic o superiore

    L'API è inclusa in tutti gli abbonamenti a pagamento da Basic in su, mensili o annuali. I crediti spesi tramite l'API escono dallo stesso saldo del sito.

  2. 2

    Crea una chiave API

    Apri Strumenti → MCP, dai un nome alla chiave e copiala. Inizia con fa_live_, viene mostrata una sola volta e puoi revocarla quando vuoi.

  3. 3

    Aggiungi FlyAIgh al tuo agente

    Incolla una delle configurazioni qui sotto, poi chiedi al tuo agente un'immagine o un video con parole tue.

Collega il tuo client

Sostituisci fa_live_your_key con la tua chiave. Non salvarla in file condivisi o nei repository.

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"

Poi imposta la chiave nel terminale: 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" }
    }
  }
}

Altri client (solo stdio)

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

Per i client che possono avviare solo un comando locale, mcp-remote fa da ponte verso l'endpoint HTTP.

Strumenti

L'agente vede otto strumenti. Due spendono crediti; gli altri si limitano a leggere.

list_models
Modelli di immagini o video con modalità, durate, risoluzioni, formati, limiti dei riferimenti e un prezzo di esempio.
quote
I crediti esatti di una richiesta, con gli stessi controlli e lo stesso prezzo della chiamata reale. Non viene addebitato nulla.
generate_image
Avvia un'immagine da testo, oppure modifica e segui le tue immagini di riferimento. Spende crediti.
generate_video
Avvia un video da testo, da un primo fotogramma, da primo e ultimo fotogramma, o da immagini, video e audio di riferimento. Spende crediti.
get_job
Lo stato di un lavoro. Quando è pronto, un link per scaricarlo; i lavori falliti vengono rimborsati automaticamente.
list_my_generations
Le tue generazioni recenti, da riusare come riferimento o da scaricare di nuovo.
upload_file
Carica una tua immagine, un video o un audio e ottieni un id file da usare come riferimento.
get_balance
Crediti rimasti, il tuo piano e quanto ha speso questa chiave oggi e questo mese.

Cosa chiedere

Usa FlyAIgh per fare un video di 5 secondi in 9:16 di una barchetta di carta che scivola lungo una strada piovosa di notte. Mostrami prima il prezzo, poi generalo e salva il file in ./out.

Un buon agente chiama quote, ti chiede conferma, genera con expected_credits e un idempotency_key, poi interroga get_job finché il file non è pronto.

Prezzi e limiti

  • Gli stessi crediti del sito per lo stesso modello e le stesse impostazioni. Nessun sovrapprezzo per l'API e nessuna fattura separata.
  • La spesa è limitata dal tuo saldo crediti. Nella pagina MCP puoi anche dare a una chiave un proprio limite giornaliero; di base non c'è. Quanto ha speso ogni chiave, giorno per giorno, lo trovi nella stessa pagina.
  • Se il prezzo cambia tra quote e la generazione, non viene addebitato nulla e torna il nuovo prezzo (expected_credits).
  • Ogni chiave può inviare 10 lavori al minuto, così un ciclo fuori controllo si ferma presto. Riprovare con lo stesso idempotency_key entro 24 ore non addebita mai due volte.
  • Caricamenti: immagini fino a 25 MB, video fino a 200 MB, audio fino a 30 MB; caricamenti in base64 fino a 3 MB. Come riferimento si possono usare solo i tuoi file e le tue generazioni.
  • I lavori falliti vengono rimborsati automaticamente. Gli originali privati arrivano come link firmati che scadono dopo un'ora.

Domande

Che piano serve per l'API di FlyAIgh?

Qualsiasi abbonamento da Basic in su, mensile o annuale. Gli account gratuiti e quelli che hanno comprato solo il pacchetto di prova o un pacchetto di crediti non possono creare chiavi. Se l'abbonamento termina, le chiavi vanno in pausa e tornano a funzionare quando ti riabboni.

Come viene addebitato l'uso dell'API?

In crediti, dallo stesso saldo che usi sul sito e allo stesso prezzo per lo stesso modello e le stesse impostazioni. Chiama quote per vedere il prezzo esatto prima di generare. Usare l'API non costa nulla in più.

Quali modelli può usare il mio agente?

Tutti i modelli di immagini e video di FlyAIgh. Lo strumento list_models restituisce l'elenco aggiornato con modalità, durate, risoluzioni e un prezzo di esempio per ogni modello, così l'agente vede sempre ciò che offre il sito.

Posso usare immagini, video o audio miei?

Sì. upload_file dà al tuo agente un link per il caricamento (o accetta direttamente un file piccolo) e restituisce un id da usare come primo fotogramma o riferimento. Vanno bene anche le generazioni precedenti della libreria.

La mia chiave API è al sicuro?

Conserviamo solo un hash della chiave, che ti viene mostrata una sola volta; puoi revocarla quando vuoi nella pagina MCP e una chiave revocata smette subito di funzionare. Trattala come una password: tienila in una variabile d'ambiente, non in un file condiviso.

Funziona con ChatGPT o con le app di Claude?

Per ora il server usa chiavi API, supportate da agenti di programmazione come Claude Code, Codex e Cursor. I connettori con un clic per le app di ChatGPT e Claude richiedono l'accesso OAuth, che è in programma.

Porta i modelli nel tuo flusso di lavoro

Crea una chiave, aggiungi una riga al tuo agente e genera immagini e video senza lasciare l'editor o il terminale.

Crea una chiave API