Entwickler · MCP
Bilder und Videos direkt aus deinem KI-Agenten
Mit dem FlyAIgh MCP-Server nutzen Claude Code, Codex, Cursor und andere MCP-Clients alle Bild- und Videomodelle auf FlyAIgh: Preise abfragen, generieren, eigene Referenzdateien verwenden und Ergebnisse herunterladen – alles über ein Credit-Guthaben.
Erfordert ein Basic-Abo oder höher.
Endpunkt
- URL
- https://www.flyaigh.com/api/mcp
- Transport
- Streamable HTTP (zustandslos)
- Authentifizierung
- Authorization: Bearer <dein API-Schlüssel>
In drei Schritten eingerichtet
- 1
Basic oder höher abonnieren
Die API ist in jedem bezahlten Abo ab Basic enthalten, monatlich oder jährlich. Credits, die du über die API ausgibst, kommen aus demselben Guthaben wie auf der Website.
- 2
API-Schlüssel erstellen
Öffne Werkzeuge → MCP, benenne den Schlüssel und kopiere ihn. Er beginnt mit fa_live_, wird nur einmal angezeigt und lässt sich jederzeit widerrufen.
- 3
FlyAIgh zum Agenten hinzufügen
Füge eine der Konfigurationen unten ein und bitte deinen Agenten dann in eigenen Worten um ein Bild oder Video.
Client verbinden
Ersetze fa_live_your_key durch deinen Schlüssel. Lege ihn nicht in geteilten Dateien oder Repositories ab.
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"Setze den Schlüssel danach in deiner Shell: 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" }
}
}
}Andere Clients (nur stdio)
npx -y mcp-remote https://www.flyaigh.com/api/mcp \
--header "Authorization: Bearer fa_live_your_key"Für Clients, die nur einen lokalen Befehl starten können, verbindet mcp-remote mit dem HTTP-Endpunkt.
Tools
Agenten sehen acht Tools. Zwei davon verbrauchen Credits, die übrigen lesen nur.
- list_models
- Bild- oder Videomodelle mit Modi, Längen, Auflösungen, Seitenverhältnissen, Referenzlimits und einem Beispielpreis.
- quote
- Die genauen Credits einer Anfrage, mit denselben Prüfungen und demselben Preis wie der echte Aufruf. Es wird nichts abgebucht.
- generate_image
- Startet ein Bild: aus Text oder auf Basis deiner Referenzbilder. Verbraucht Credits.
- generate_video
- Startet ein Video aus Text, einem ersten Frame, erstem und letztem Frame oder aus Referenzbildern, -videos und -audio. Verbraucht Credits.
- get_job
- Status eines Auftrags. Wenn er fertig ist, ein Download-Link; fehlgeschlagene Aufträge werden automatisch erstattet.
- list_my_generations
- Deine letzten Generierungen, um eine als Referenz wiederzuverwenden oder erneut herunterzuladen.
- upload_file
- Lade ein eigenes Bild, Video oder Audio hoch und erhalte eine Datei-ID für die Verwendung als Referenz.
- get_balance
- Verbleibende Credits, dein Tarif und was dieser Schlüssel heute und diesen Monat verbraucht hat.
Was du fragen kannst
Erstelle mit FlyAIgh ein 5-Sekunden-Video im Format 9:16: Ein Papierboot treibt nachts eine verregnete Straße hinunter. Zeig mir zuerst den Preis, generiere es dann und speichere die Datei unter ./out.
Ein guter Agent ruft quote auf, holt deine Bestätigung ein, generiert mit expected_credits und einem idempotency_key und fragt get_job ab, bis die Datei fertig ist.
Preise und Limits
- Dieselben Credits wie auf der Website für dasselbe Modell und dieselben Einstellungen. Kein API-Aufschlag und keine separate API-Rechnung.
- Die Ausgaben begrenzt dein Credit-Guthaben. Auf der MCP-Seite kannst du einem Schlüssel zusätzlich ein eigenes Tageslimit geben; standardmäßig gibt es keins. Was jeder Schlüssel Tag für Tag verbraucht hat, steht auf derselben Seite.
- Ändert sich der Preis zwischen quote und Generierung, wird nichts abgebucht und der neue Preis zurückgegeben (expected_credits).
- Jeder Schlüssel darf 10 Aufträge pro Minute senden, damit eine außer Kontrolle geratene Schleife schnell stoppt. Wiederholungen mit demselben idempotency_key innerhalb von 24 Stunden buchen nie doppelt ab.
- Uploads: Bilder bis 25 MB, Videos bis 200 MB, Audio bis 30 MB; Base64-Uploads bis 3 MB. Als Referenz dienen nur deine eigenen Dateien und Generierungen.
- Fehlgeschlagene Aufträge werden automatisch erstattet. Private Originale kommen als signierte Links zurück, die nach einer Stunde ablaufen.
Fragen
Welchen Tarif brauche ich für die FlyAIgh-API?
Jedes Abo ab Basic, monatlich oder jährlich. Kostenlose Konten und Konten, die nur das Starterpaket oder ein Credit-Paket gekauft haben, können keine Schlüssel erstellen. Endet dein Abo, werden die Schlüssel pausiert und funktionieren wieder, sobald du erneut abonnierst.
Wie wird die API-Nutzung abgerechnet?
In Credits, aus demselben Guthaben wie auf der Website und zum selben Preis für dasselbe Modell und dieselben Einstellungen. Mit quote siehst du den genauen Preis vor dem Generieren. Für die API fallen keine zusätzlichen Gebühren an.
Welche Modelle kann mein Agent nutzen?
Alle Bild- und Videomodelle auf FlyAIgh. Das Tool list_models liefert die aktuelle Liste mit Modi, Längen, Auflösungen und einem Beispielpreis je Modell, sodass der Agent immer dasselbe Angebot sieht wie die Website.
Kann ich eigene Bilder, Videos oder Audiodateien verwenden?
Ja. upload_file gibt deinem Agenten einen Upload-Link (oder nimmt kleine Dateien direkt an) und liefert eine Datei-ID, die als erster Frame oder Referenz dient. Frühere Generierungen aus deiner Bibliothek funktionieren ebenfalls.
Ist mein API-Schlüssel sicher?
Wir speichern nur einen Hash des Schlüssels, er wird dir nur einmal angezeigt und du kannst ihn jederzeit auf der MCP-Seite widerrufen; widerrufene Schlüssel funktionieren sofort nicht mehr. Behandle ihn wie ein Passwort: in einer Umgebungsvariable, nicht in einer geteilten Datei.
Funktioniert das mit ChatGPT oder den Claude-Apps?
Derzeit nutzt der Server API-Schlüssel, die Coding-Agenten wie Claude Code, Codex und Cursor unterstützen. Ein-Klick-Connectoren für die ChatGPT- und Claude-Apps benötigen eine OAuth-Anmeldung; die ist geplant.
Hol die Modelle in deinen Workflow
Schlüssel erstellen, eine Zeile in deinem Agenten ergänzen und Bilder und Videos erzeugen, ohne Editor oder Terminal zu verlassen.
API-Schlüssel erstellen