Ein Aufruf, fertiges Medium
run sendet die Generierung ab, fragt mit dem von der API empfohlenen Backoff den Status ab und liefert die abgeschlossene Anfrage mit result.url zurück.
Auf einen Blick
Mage veröffentlicht Open-Source-SDKs für seine API: @mage-space/sdk auf npm für TypeScript und JavaScript, mage-space auf PyPI für Python und das Node-Paket comfyui-mage für ComfyUI. Alle kapseln die REST-API mit typisierten Konfigurationen für alle 28 Modelle, automatischem Polling, idempotenten Wiederholungen und Uploads.
3
SDKs und Integrationen
28
Typisierte Modelle
MIT
Open Source
$0
Zum Installieren
Such dir deins aus
SDKs und Integrationen
npm install @mage-space/sdk
TypeScript SDK
Generiere Bilder, Videos und Audio aus Node.js mit typisierten Konfigurationen für jedes Mage-Modell. Ein Aufruf sendet die Anfrage, wartet und liefert das Ergebnis.
pip install mage-space
Python SDK
Generiere Bilder, Videos und Audio aus Python mit synchronen und asyncio-Clients sowie typisierten Konfigurationen für jedes Mage-Modell.
comfy node install comfyui-mage
Mage für ComfyUI
Mango, Cherry, Seed Audio und alle anderen Mage-Modelle als ComfyUI-Nodes. Ohne GPU, ohne Modell-Downloads.
Schnellstart
Deine erste Generierung mit einem SDK
Installiere das Paket, exportiere MAGE_API_KEY und führe ein Modell aus.
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-v3',
});
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-v3",
})
print(request["result"]["url"])Integriert
Was jedes SDK für dich übernimmt
Wiederholungen ohne doppelte Kosten
Jede Anfrage enthält einen Idempotenzschlüssel. Netzwerk- und Serverfehler werden mit Backoff wiederholt, und eine wiederholte Anfrage wird nie erneut berechnet.
Uploads in einem Aufruf
Dateien, die für eine Data-URL zu groß sind, laufen über einen signierten Upload. Ticket, PUT und Größenprüfung übernehmen wir für dich.
Klare Fehlermeldungen
Ablehnungen der API enthalten HTTP-Status, Fehlercode und Request-ID; fehlgeschlagene oder abgebrochene Generierungen und Timeouts haben eigene Fehlertypen.
Pakete
Wo du sie bekommst
| SDK | Paket | Installation | Quellcode |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| Mage für ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Häufig gestellte Fragen
Sind die Mage SDKs kostenlos und Open Source?
Ja. Die SDKs und die ComfyUI-Nodes stehen auf GitHub unter der MIT-Lizenz, und die Installation ist kostenlos. Du zahlst nur für die Generierungen, die du ausführst – in Gems, zum jeweils angegebenen Preis des Modells.
Funktionieren neue Mage-Modelle mit einem älteren SDK?
Ja. Übergib die ID des neuen Modells als String, dann läuft es. Das SDK prüft die Konfiguration anhand der Felder, die alle Modelle gemeinsam haben. Ein Bot aktualisiert die Typen, sobald sich die API-Referenz ändert, sodass neue Modelle mit eigenen Typen im nächsten Release erscheinen.
Wie verhindern die SDKs, dass ich bei einer wiederholten Anfrage doppelt zahle?
Jede Übermittlung enthält einen Idempotency-Key. Das SDK erzeugt pro Aufruf einen neuen Key und verwendet ihn erneut, wenn es diesen Aufruf selbst wiederholt. So gibt eine wiederholte Übermittlung die ursprüngliche Anfrage zurück und es fallen keine Kosten an.
Sind die SDKs stabil?
Sie befinden sich als 0.x in der Beta, daher kann sich mit einer Minor-Version noch etwas ändern. Die API selbst wird separat versioniert und bleibt innerhalb von v1 stabil.
Was kostet die Mage API?
Es gibt kein Abo und keine monatliche Gebühr. Jede Generierung wird in Gems zum angegebenen Preis des Modells bezahlt, und 1.000 Gems kosten im Standardpaket 1 $. Jede Modellseite nennt den Preis bei Standardeinstellungen, und jede Antwort enthält die genaue Abrechnung. Eine fehlgeschlagene Generierung wird erstattet; eine, die von der Inhaltsrichtlinie von Mage blockiert wird, nicht. Eine Anfrage, die dein Guthaben nicht deckt, wird abgelehnt, bevor etwas berechnet wird.
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Nein. Die API läuft ausschließlich über Gems. Mitgliedschaften und ihre unbegrenzten Generierungen in der App gelten nicht für API-Anfragen, daher kann jedes Mage-Konto mit Gems sie nutzen.
Kann ich API-Ergebnisse kommerziell nutzen?
Ja. Inhalte, die du mit Mage erstellst, auch über die API und den MCP-Server, kannst du kommerziell nutzen. Eine Namensnennung freut uns, ist aber nicht erforderlich.
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.