Mage API · SDKs
Offizielle SDKs für die Mage API
Typisierte Clients für TypeScript und Python sowie Mage-Nodes für ComfyUI. Jedes Bild-, Video- und Audiomodell in wenigen Zeilen Code.
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. Jedes SDK kapselt die REST-API mit typisierten Konfigurationen für alle 37 Modelle, automatischem Polling, idempotenten Wiederholungen und Uploads.
- 3SDKs und Integrationen
- 37Typisierte Modelle
- MITOpen Source
- $0Zum Installieren
Such dir deins aus
SDKs und Integrationen
npm install @mage-space/sdkTypeScript 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-spacePython 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-mageMage 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-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"])Integriert
Was jedes SDK für dich übernimmt
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.
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?
Funktionieren neue Mage-Modelle mit einem älteren SDK?
Wie verhindern die SDKs, dass ich bei einer wiederholten Anfrage doppelt zahle?
Sind die SDKs stabil?
Was kostet die Mage API?
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Kann ich API-Ergebnisse kommerziell nutzen?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.