Eén aanroep, kant-en-klare media
run verstuurt de generatie, pollt met de backoff die de API aanbeveelt en levert de voltooide aanvraag op met result.url.
In één oogopslag
Mage publiceert open-source SDK's voor zijn API: @mage-space/sdk op npm voor TypeScript en JavaScript, mage-space op PyPI voor Python en het nodepakket comfyui-mage voor ComfyUI. Elke SDK omhult de REST API met getypeerde configuraties voor alle 28 modellen, automatische polling, idempotente nieuwe pogingen en uploads.
3
SDK's en integraties
28
Getypeerde modellen
MIT
Open source
$0
Installeren
Kies de jouwe
SDK's en integraties
npm install @mage-space/sdk
TypeScript SDK
Genereer afbeeldingen, video en audio vanuit Node.js met getypeerde configuraties voor elk Mage-model. Eén aanroep verstuurt, wacht en geeft het resultaat terug.
pip install mage-space
Python SDK
Genereer afbeeldingen, video en audio vanuit Python met sync- en asyncio-clients en getypeerde configuraties voor elk Mage-model.
comfy node install comfyui-mage
Mage voor ComfyUI
Mango, Cherry, Seed Audio en alle andere Mage-modellen als ComfyUI-nodes. Geen GPU, geen modellen downloaden.
Snel starten
Je eerste generatie met een SDK
Installeer het pakket, exporteer MAGE_API_KEY en draai een model.
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"])Ingebouwd
Wat elke SDK voor je regelt
Nieuwe pogingen zonder dubbel te betalen
Elke aanvraag heeft een idempotentiesleutel. Netwerkfouten en serverfouten worden met backoff opnieuw geprobeerd en een opnieuw verstuurde aanvraag wordt nooit nogmaals in rekening gebracht.
Uploads in één aanroep
Bestanden die te groot zijn voor een data-URL gaan via een ondertekende upload. Het ticket, de PUT en de groottecontrole worden voor je afgehandeld.
Duidelijke foutmeldingen
Weigeringen van de API bevatten hun HTTP-status, foutcode en aanvraag-ID. Mislukte of geannuleerde generaties en time-outs hebben elk hun eigen fouttype.
Pakketten
Waar vind je ze
| SDK | Pakket | Installatie | Broncode |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| Mage voor ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Veelgestelde vragen
Zijn de Mage SDK's gratis en open source?
Ja. De SDK's en de ComfyUI-nodes hebben een MIT-licentie op GitHub en installeren kost niks. Je betaalt alleen voor de generaties die je uitvoert, in Gems, tegen de vermelde prijs van elk model.
Werken nieuwe Mage-modellen met een oudere SDK?
Ja. Geef de id van het nieuwe model door als string en het draait; de SDK controleert de config aan de hand van de velden die alle modellen delen. Een bot werkt de types bij zodra de API-referentie verandert, dus nieuwe modellen komen met hun eigen types mee in de volgende release.
Hoe voorkomen de SDK's dat je twee keer betaalt voor een opnieuw verzonden verzoek?
Elke aanvraag bevat een Idempotency-Key. De SDK maakt per aanroep een nieuwe sleutel en gebruikt die opnieuw als hij die aanroep zelf opnieuw probeert. Zo geeft een herhaalde aanvraag het oorspronkelijke verzoek terug en worden er geen kosten in rekening gebracht.
Zijn de SDK's stabiel?
Ze zijn in bèta op 0.x, dus een minor-versie kan ze nog wijzigen. De API zelf heeft een aparte versienummering en blijft stabiel binnen v1.
Hoeveel kost de Mage API?
Er is geen abonnement of maandelijks bedrag. Elke generatie betaal je in Gems tegen de vermelde prijs van het model, en 1.000 Gems kosten $1 met het standaardpakket. Op elke modelpagina staat de prijs met standaardinstellingen en elke respons toont de exacte kosten. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet. Een aanvraag die je saldo niet dekt, wordt geweigerd voordat er iets in rekening wordt gebracht.
Heb ik een Mage-lidmaatschap nodig om de API te gebruiken?
Nee. De API werkt alleen met Gems. Lidmaatschappen en hun onbeperkte generatie in de app gelden niet voor API-aanvragen, dus elk Mage-account met Gems kan de API aanroepen.
Mag ik API-uitvoer commercieel gebruiken?
Ja. Content die je met Mage maakt, ook via de API en de MCP-server, mag je commercieel gebruiken. Naamsvermelding wordt gewaardeerd, maar is niet verplicht.
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.