Développeurs · MCP
Générez images et vidéos depuis votre agent IA
Le serveur MCP FlyAIgh permet à Claude Code, Codex, Cursor et aux autres clients MCP d'utiliser tous les modèles d'image et de vidéo de FlyAIgh : consulter les prix, générer, utiliser vos propres fichiers de référence et télécharger les résultats, avec un seul solde de crédits.
Nécessite un abonnement Basic ou supérieur.
Point d'accès
- URL
- https://www.flyaigh.com/api/mcp
- Transport
- Streamable HTTP (sans état)
- Authentification
- Authorization: Bearer <votre clé API>
Configuration en trois étapes
- 1
Abonnez-vous à Basic ou plus
L'API est incluse dans tous les abonnements payants à partir de Basic, mensuels ou annuels. Les crédits dépensés via l'API viennent du même solde que sur le site.
- 2
Créez une clé API
Ouvrez Outils → MCP, nommez la clé et copiez-la. Elle commence par fa_live_, n'est affichée qu'une fois et peut être révoquée à tout moment.
- 3
Ajoutez FlyAIgh à votre agent
Collez l'une des configurations ci-dessous, puis demandez simplement une image ou une vidéo à votre agent.
Connectez votre client
Remplacez fa_live_your_key par votre clé. Ne la placez pas dans des fichiers partagés ni dans un dépôt.
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"Puis définissez la clé dans votre 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" }
}
}
}Autres clients (stdio uniquement)
npx -y mcp-remote https://www.flyaigh.com/api/mcp \
--header "Authorization: Bearer fa_live_your_key"Pour les clients qui ne lancent qu'une commande locale, mcp-remote fait le pont avec le point d'accès HTTP.
Outils
Les agents voient huit outils. Deux dépensent des crédits ; les autres ne font que lire.
- list_models
- Les modèles d'image ou de vidéo avec leurs modes, durées, résolutions, formats, limites de références et un prix d'exemple.
- quote
- Le nombre exact de crédits d'une requête, avec les mêmes vérifications et le même prix que l'appel réel. Rien n'est débité.
- generate_image
- Lance une image : texte vers image, ou retouche et suivi de vos images de référence. Dépense des crédits.
- generate_video
- Lance une vidéo à partir d'un texte, d'une première image, des premières et dernières images, ou d'images, vidéos et sons de référence. Dépense des crédits.
- get_job
- L'état d'une tâche. Une fois terminée, un lien de téléchargement ; les tâches échouées sont remboursées automatiquement.
- list_my_generations
- Vos générations récentes, pour en réutiliser une comme référence ou la retélécharger.
- upload_file
- Envoyez votre propre image, vidéo ou son et obtenez un identifiant de fichier à utiliser comme référence.
- get_balance
- Crédits restants, votre offre, et ce que cette clé a dépensé aujourd'hui et ce mois-ci.
Que demander
Utilise FlyAIgh pour faire une vidéo de 5 secondes en 9:16 d'un bateau en papier qui dérive dans une rue pluvieuse la nuit. Montre-moi d'abord le prix, puis génère-la et enregistre le fichier dans ./out.
Un bon agent appelle quote, vous demande de confirmer, génère avec expected_credits et un idempotency_key, puis interroge get_job jusqu'à ce que le fichier soit prêt.
Prix et limites
- Les mêmes crédits que sur le site pour le même modèle et les mêmes réglages. Aucun supplément pour l'API, ni facture à part.
- La dépense est limitée par votre solde de crédits. Vous pouvez aussi donner à une clé son propre plafond quotidien sur la page MCP ; par défaut il n'y en a pas. Ce que chaque clé a dépensé, jour par jour, figure sur la même page.
- Si le prix change entre quote et la génération, rien n'est débité et le nouveau prix est renvoyé (expected_credits).
- Chaque clé peut soumettre 10 tâches par minute : une boucle qui s'emballe s'arrête vite. Réessayer avec le même idempotency_key sous 24 heures ne débite jamais deux fois.
- Envois : images jusqu'à 25 Mo, vidéos jusqu'à 200 Mo, audio jusqu'à 30 Mo ; envois en base64 jusqu'à 3 Mo. Seuls vos propres fichiers et générations peuvent servir de référence.
- Les tâches échouées sont remboursées automatiquement. Les originaux privés sont renvoyés sous forme de liens signés valables une heure.
Questions
Quelle offre faut-il pour l'API FlyAIgh ?
Tout abonnement à partir de Basic, mensuel ou annuel. Les comptes gratuits et ceux qui n'ont acheté que le pack découverte ou un pack de crédits ne peuvent pas créer de clé. Si votre abonnement se termine, vos clés sont mises en pause et refonctionnent dès que vous vous réabonnez.
Comment l'usage de l'API est-il facturé ?
En crédits, sur le même solde que sur le site, au même prix pour le même modèle et les mêmes réglages. Appelez quote pour voir le prix exact avant de générer. L'API n'entraîne aucun frais supplémentaire.
Quels modèles mon agent peut-il utiliser ?
Tous les modèles d'image et de vidéo de FlyAIgh. L'outil list_models renvoie la liste actuelle avec les modes, durées, résolutions et un prix d'exemple pour chaque modèle : l'agent voit toujours la même offre que le site.
Puis-je utiliser mes propres images, vidéos ou sons ?
Oui. upload_file donne à votre agent un lien d'envoi (ou accepte un petit fichier en ligne) et renvoie un identifiant à passer comme première image ou référence. Vos générations précédentes de la bibliothèque fonctionnent aussi.
Ma clé API est-elle en sécurité ?
Nous ne conservons qu'une empreinte de la clé, elle ne vous est montrée qu'une fois et vous pouvez la révoquer à tout moment sur la page MCP ; une clé révoquée cesse aussitôt de fonctionner. Traitez-la comme un mot de passe : gardez-la dans une variable d'environnement, pas dans un fichier partagé.
Est-ce compatible avec ChatGPT ou les applications Claude ?
Pour l'instant le serveur utilise des clés API, prises en charge par des agents de code comme Claude Code, Codex et Cursor. Les connecteurs en un clic pour les applications ChatGPT et Claude exigent une connexion OAuth, prévue prochainement.
Intégrez les modèles à votre façon de travailler
Créez une clé, ajoutez une ligne à votre agent et générez images et vidéos sans quitter votre éditeur ni votre terminal.
Créer une clé API