Ugrás a tartalomhoz
PlaygroundDokumentációAPI-kulcs igénylése

Mage API · SDK-k

Hivatalos SDK-k a Mage API-hoz

Típusos kliensek TypeScripthez és Pythonhoz, valamint Mage node-ok ComfyUI-hoz. Minden kép-, videó- és hangmodell néhány sor kódban.

API-kulcs kéréseSDK-dokumentáció megnyitása

Dióhéjban

A Mage nyílt forráskódú SDK-kat kínál az API-jához: @mage-space/sdk az npm-en TypeScripthez és JavaScripthez, mage-space a PyPI-n Pythonhoz, valamint a comfyui-mage node-csomag ComfyUI-hoz. Mindegyik a REST API-t csomagolja be, mind a 28 modellhez típusos konfigurációkkal, automatikus lekérdezéssel, idempotens újrapróbálkozásokkal és feltöltésekkel.

  • 3SDK-k és integrációk
  • 28Típusos modellek
  • MITNyílt forráskód
  • $0Telepítéshez

Válaszd ki a sajátod

SDK-k és integrációk

  • npm install @mage-space/sdk

    TypeScript SDK

    Generálj képeket, videókat és hangokat Node.js-ből, minden Mage modellhez típusos konfigurációkkal. Egyetlen hívás elküldi a kérést, megvárja, és visszaadja az eredményt.

  • pip install mage-space

    Python SDK

    Generálj képeket, videókat és hangokat Pythonból szinkron és asyncio kliensekkel, valamint minden Mage modellhez típusos konfigurációkkal.

  • comfy node install comfyui-mage

    Mage a ComfyUI-hoz

    A Mango, a Cherry, a Seed Audio és az összes többi Mage-modell ComfyUI-node-ként. Nincs szükség GPU-ra, és modelleket sem kell letöltened.

Gyors kezdés

Az első generálásod SDK-val

Telepítsd a csomagot, exportáld a MAGE_API_KEY változót, és futtass egy modellt.

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"])

Beépítve

Amit minden SDK elintéz helyetted

  • Egy hívás, kész média

    A run elküldi a generálást, az API által javasolt visszalépéses időzítéssel lekérdezi az állapotot, és a kész kéréssel tér vissza result.url értékkel.

  • Újrapróbálkozás kétszeri fizetés nélkül

    Minden beküldés idempotencia-kulcsot visz magával. A hálózati és szerverhibáknál visszalépéses időzítéssel újrapróbálkozik, az újra elküldött kérésért pedig soha nem számolunk fel újabb díjat.

  • Feltöltés egy hívással

    A data URL-hez túl nagy fájlok aláírt feltöltéssel mennek át, a jegyet, a PUT kérést és a méretellenőrzést pedig az SDK intézi helyetted.

  • Érthető hibák

    Az API elutasításai tartalmazzák a HTTP-státuszt, a hibakódot és a kérésazonosítót; a sikertelen vagy megszakított generálásoknak és az időtúllépéseknek saját hibatípusuk van.

Csomagok

Honnan szerezheted be őket

SDKCsomagTelepítésForrás
TypeScript SDK@mage-space/sdknpm install @mage-space/sdkGitHub
Python SDKmage-spacepip install mage-spaceGitHub
Mage ComfyUI-hozcomfyui-magecomfy node install comfyui-mageGitHub

GYIK

Gyakran ismételt kérdések

Ingyenesek és nyílt forráskódúak a Mage SDK-k?
Igen. Az SDK-k és a ComfyUI-csomópontok MIT-licenccel elérhetők a GitHubon, a telepítésük pedig ingyenes. Csak a futtatott generálásokért fizetsz Gemekben, az adott modell listaárán.
Működnek az új Mage modellek régebbi SDK-val?
Igen. Add meg az új modell azonosítóját szövegként, és már fut is; az SDK a konfigurációt a minden modellnél közös mezők alapján ellenőrzi. Egy bot frissíti a típusokat, valahányszor változik az API-dokumentáció, így az új modellek a saját típusaikkal érkeznek a következő kiadásban.
Hogyan kerüli el az SDK, hogy kétszer fizess egy újrapróbált kérésért?
Minden beküldés tartalmaz egy Idempotency-Key kulcsot. Az SDK hívásonként új kulcsot készít, és újrapróbálkozáskor ugyanazt használja újra, így az ismételt beküldés az eredeti kérést adja vissza, és nem terhel meg semmivel.
Stabilak az SDK-k?
Béta állapotban vannak, 0.x verzióval, így egy kisebb verzió még módosíthatja őket. Maga az API külön verziózott, és a v1-en belül stabil marad.
Mennyibe kerül a Mage API?
Nincs előfizetés vagy havidíj. Minden generálást Gemekkel fizetsz a modell feltüntetett árán, és a standard csomagban 1000 Gem 1 dollárba kerül. Minden modelloldalon az alapbeállításokhoz tartozó ár látható, és minden válasz megadja a pontos terhelést. A sikertelen generálás árát visszatérítjük; azt viszont nem, amelyet a Mage tartalmi irányelvei blokkoltak. Az a kérés, amelyet az egyenleged nem fedez, elutasításra kerül, mielőtt bármit terhelnénk.
Kell Mage-tagság az API használatához?
Nem. Az API kizárólag Gemekkel működik. A tagsági csomagok és a hozzájuk tartozó korlátlan alkalmazáson belüli generálás nem vonatkozik az API-kérésekre, így bármelyik Mage-fiók használhatja, amelyen van Gem.
Felhasználhatom kereskedelmi célra az API kimeneteit?
Igen. A Mage-dzsel készített tartalmakat – az API-n és az MCP-szerveren keresztül létrehozottakat is – kereskedelmi célra is felhasználhatod. A forrásmegjelölést köszönjük, de nem kötelező.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.

API-kulcs kéréseSDK-dokumentáció megnyitása