Mage API · Gemacht für deine nächste Idee
Eine API. Unendlich viele Möglichkeiten.
Bring das Beste von Mage in dein Produkt und zu deinem KI-Assistenten. Erstelle Bilder, Videos und Audio mit nur einem API-Schlüssel oder einer einzigen MCP-Verbindung.
https://api.mage.space/v1Auf einen Blick
Mage bietet Entwicklern eine REST-API unter https://api.mage.space/v1 und einen Remote-MCP-Server unter https://mcp.mage.space/mcp. Beide nutzen dieselben 37 Bild-, Video- und Audiomodelle, darunter die exklusiv bei Mage verfügbaren Mango 4 und Cherry 2 Pro, mit nur einem Konto. Jede Generierung wird in Gems bezahlt, ganz ohne Abo.
- 37Modelle
- 3Medientypen
- 16MCP-Tools
- $0Monatliche Gebühr
Deine Einstiege
Nutze es per Code, mit deinem Assistenten oder in ComfyUI
Die Mage API
Sende Generierungen mit einem Schlüssel direkt aus deinem eigenen Code. Asynchrone Anfragen, idempotente Wiederholungen, Uploads bis 100 MB und 20 gleichzeitige Generierungen.
TypeScript- und Python-SDKs
Offizielle, typisierte Clients, die in wenigen Zeilen senden, auf das Ergebnis warten, sicher wiederholen und Dateien hochladen.
Der Mage MCP-Server
Verbinde Claude, ChatGPT, Claude Code, Grok oder Cursor per Anmeldung und frag in einfachen Worten nach Bildern, Videos und Audio.
Mage für ComfyUI
Mango, Cherry, Seed Audio und alle anderen Mage-Modelle als ComfyUI-Nodes. Ohne GPU, ohne Modell-Downloads.
Nach Medientyp
Generierungs-APIs
API für KI-Bildgenerierung
Text-zu-Bild, Bearbeitung und konsistente Charaktere bis 4K.
API für KI-Videogenerierung
Text-zu-Video, Bild-zu-Video, Frames, Referenzen und Ton.
API für KI-Audiogenerierung
Stimmen, Sprecher, Musik und Soundeffekte aus einem Prompt.
Schnellstart
Deine erste Generierung
Erstelle unter API → API Keys einen Schlüssel, exportiere ihn als MAGE_API_KEY und führe eines dieser Beispiele aus.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
print(request["result"]["url"])So funktioniert's
Vom API-Schlüssel zum fertigen Medium in drei Aufrufen
Alle Modelle teilen sich ein Authentifizierungsschema, einen asynchronen Anfrageablauf und dieselben Feldnamen.
API-Schlüssel erstellen
Melde dich bei Mage an, öffne API → API Keys und erstelle einen Schlüssel. Er beginnt mit mage_sk_ und wird nur einmal angezeigt. Ein Konto kann 10 aktive Schlüssel haben.
Generierung senden
Sende per POST einen JSON-Body an https://api.mage.space/v1/{model}/generate, mit einem Authorization: Bearer-Header. Die Antwort kommt sofort und enthält eine request_id, einen status und eine status_url. Sende einen Idempotency-Key-Header, damit eine Wiederholung nie doppelt kostet.
Abfragen und herunterladen
Frage die status_url ab, bis der Status completed, failed oder cancelled ist. Eine abgeschlossene Anfrage enthält result.url mit der Bild-, Video- oder Audiodatei, die 30 Tage lang gespeichert bleibt.
MCP
Mage in deinem KI-Assistenten
Mage in Claude
Erstelle Bilder, Videos und Audio in Claude im Web, in der Desktop-App, in den mobilen Apps und in Cowork.
Mage in ChatGPT
Erstelle Bilder, Videos und Audio in ChatGPT als persönliche MCP-App.
Mage in Claude Code
Erstelle Bilder, Videos und Audio in Claude Code, in deinem Terminal und Editor.
Mage in Grok
Erstelle Bilder, Videos und Audio in Grok als benutzerdefinierten Connector.
Mage in Cursor
Erstelle Bilder, Videos und Audio im Agent-Modus von Cursor.
Modelle
Ausgewählte Modelle
Flux 2 API
Lange Prompts und Bearbeitungen mit mehreren Referenzen
GPT Image 2 API
Präzise Prompts und lesbarer Text
Guava API
Fotorealismus, der als Foto durchgeht
Mango API
Unsere Flaggschiff-Bildfamilie
Nano Banana 2 API
Gestochen scharfer, lesbarer Text, bis zu 4K
Cherry API
Unsere Flaggschiff-Videofamilie
Lemon API
Alle Video-Funktionen zu einem fairen Preis
Plum API
Ton in jedem Clip, bis zu 2K
Seed Audio API
Stimmen, Musik und Soundeffekte aus einem Prompt
Für den Produktiveinsatz gebaut
Das bekommt jede Anfrage an die Mage API
Ein Schlüssel, alle Modelle
37 Bild-, Video- und Audiomodelle hinter einer REST-API und einem Gems-Guthaben. Wechsle das Modell, indem du den URL-Pfad änderst.
Zahlung pro Generierung
Kein Abo und kein Mindestumsatz. Du kaufst Gems, und jede Anfrage kostet ihren angegebenen Preis. Eine fehlgeschlagene Generierung wird erstattet, es sei denn, die Inhaltsrichtlinie von Mage hat sie blockiert.
Sichere Wiederholungen
Mit Idempotency-Keys liefert ein erneut gesendeter Request die ursprüngliche Anfrage zurück, ohne erneut abzurechnen.
Konsistente Charaktere
Speichere einen Charakter oder eine Referenz einmal und schreibe dann @handle in einen beliebigen Prompt, um sie mit jedem unterstützten Modell zu verwenden.
Große Eingaben
Sende Bild-, Video- und Audioeingaben als URLs oder Data-URLs oder lade Dateien bis 100 MB über einen signierten Upload hoch.
20 Generierungen gleichzeitig
Jedes Konto kann 20 Generierungen gleichzeitig ausführen, und das Limit lässt sich für deinen Anwendungsfall erhöhen. Abgelehnte Anfragen werden nie berechnet.
FAQ
Häufig gestellte Fragen
Was ist die Mage API?
Was ist der Mage MCP-Server?
Brauche ich einen API-Schlüssel, um den MCP-Server zu nutzen?
Was kostet die Mage API?
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Kann ich API-Ergebnisse kommerziell nutzen?
Welche Rate Limits gibt es?
Kann mein KI-Agent die Mage API nutzen?
Gibt es ein SDK für die Mage API?
Ich nutze bereits eine andere Generierungs-API. Was muss ich ändern?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.