Mage API · SDK's
Officiële SDK's voor de Mage API
Getypeerde clients voor TypeScript en Python, en Mage-nodes voor ComfyUI. Elk model voor afbeeldingen, video en audio in een paar regels code.
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. Elk omhult de REST API met getypeerde configs voor alle 37 modellen, automatisch pollen, idempotente nieuwe pogingen en uploads.
- 3SDK's en integraties
- 37Getypeerde modellen
- MITOpen source
- $0Installeren
Kies de jouwe
SDK's en integraties
npm install @mage-space/sdkTypeScript 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-spacePython SDK
Genereer afbeeldingen, video en audio vanuit Python met sync- en asyncio-clients en getypeerde configuraties voor elk Mage-model.
comfy node install comfyui-mageMage 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-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"])Ingebouwd
Wat elke SDK voor je regelt
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.
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?
Werken nieuwe Mage-modellen met een oudere SDK?
Hoe voorkomen de SDK's dat je twee keer betaalt voor een opnieuw verzonden verzoek?
Zijn de SDK's stabiel?
Hoeveel kost de Mage API?
Heb ik een Mage-lidmaatschap nodig om de API te gebruiken?
Mag ik API-uitvoer commercieel gebruiken?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.