Přeskočit na obsah
PlaygroundDokumentaceZískat API klíč

Mage API · SDK

Oficiální SDK pro Mage API

Typované klienty pro TypeScript a Python a uzly Mage pro ComfyUI. Všechny modely pro obrázky, videa a audio na pár řádků kódu.

Získat API klíčČíst dokumentaci k SDK

Stručně

Mage zveřejňuje open-source SDK pro své API: @mage-space/sdk na npm pro TypeScript a JavaScript, mage-space na PyPI pro Python a sadu uzlů comfyui-mage pro ComfyUI. Každé z nich obaluje REST API typovanými konfiguracemi pro všech 28 modelů, automatickým dotazováním na stav, idempotentními opakovanými pokusy a nahráváním souborů.

  • 3SDK a integrace
  • 28Typované modely
  • MITOpen source
  • $0Instalace

Vyber si

SDK a integrace

  • npm install @mage-space/sdk

    SDK pro TypeScript

    Generuj obrázky, videa a audio z Node.js s typovanými konfiguracemi pro každý model Mage. Jedno volání odešle požadavek, počká a vrátí výsledek.

  • pip install mage-space

    SDK pro Python

    Generuj obrázky, videa a audio z Pythonu se synchronními i asyncio klienty a typovanými konfiguracemi pro každý model Mage.

  • comfy node install comfyui-mage

    Mage pro ComfyUI

    Mango, Cherry, Seed Audio a všechny další modely Mage jako uzly ComfyUI. Bez GPU a bez stahování modelů.

Rychlý start

Tvé první generování se SDK

Nainstaluj balíček, exportuj MAGE_API_KEY a spusť 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"])

Vestavěno

O co se každé SDK postará za tebe

  • Jedno volání, hotová média

    run odešle generování, dotazuje se na stav s odstupy doporučenými API a vrátí dokončený požadavek s result.url.

  • Opakování, která nikdy neúčtují dvakrát

    Každý požadavek nese idempotentní klíč. Při chybách sítě a serveru se pokus opakuje s postupně rostoucími odstupy a opakovaný požadavek se nikdy nezpoplatní znovu.

  • Nahrávání jedním voláním

    Soubory příliš velké pro data URL se nahrávají přes podepsané nahrání, o tiket, PUT i kontrolu velikosti se postaráme za tebe.

  • Srozumitelné chyby

    Odmítnutí ze strany API obsahují HTTP status, kód chyby a ID požadavku; neúspěšná nebo zrušená generování a vypršení časového limitu mají vlastní typy chyb.

Balíčky

Kde je získat

SDKBalíčekInstalaceZdroj
SDK pro TypeScript@mage-space/sdknpm install @mage-space/sdkGitHub
SDK pro Pythonmage-spacepip install mage-spaceGitHub
Mage pro ComfyUIcomfyui-magecomfy node install comfyui-mageGitHub

Časté dotazy

Často kladené otázky

Jsou Mage SDK zdarma a open source?
Ano. SDK i uzly pro ComfyUI mají na GitHubu licenci MIT a jejich instalace je zdarma. Platíš jen za generování, která spustíš, v Gems, za uvedenou cenu každého modelu.
Fungují nové modely Mage i se starším SDK?
Ano. Předej id nového modelu jako řetězec a poběží; SDK zkontroluje jeho konfiguraci podle polí, která sdílejí všechny modely. Bot aktualizuje typy při každé změně v API referenci, takže nové modely dorazí s vlastními typy v dalším vydání.
Jak SDK zabrání dvojímu zaplacení za opakovaný požadavek?
Každé odeslání nese hlavičku Idempotency-Key. SDK vytvoří nový klíč pro každé volání a použije ho znovu, když to volání samo opakuje, takže opakované odeslání vrátí původní požadavek a nic se neúčtuje.
Jsou SDK stabilní?
Jsou v betě ve verzi 0.x, takže je může změnit i vedlejší verze. Samotné API má vlastní verzování a v rámci v1 zůstává stabilní.
Kolik stojí Mage API?
Žádné předplatné ani měsíční poplatek. Každá generace se platí v Gems podle uvedené ceny modelu a 1 000 Gems stojí 1 $ ve standardním balíčku. Stránka každého modelu uvádí cenu při výchozím nastavení a každá odpověď obsahuje přesnou účtovanou částku. Neúspěšná generace se vrací; ta, kterou zablokují zásady obsahu Mage, ne. Požadavek, na který zůstatek nestačí, se odmítne dřív, než se cokoli naúčtuje.
Potřebuji k používání API členství v Mage?
Ne. API funguje jen na Gems. Členské plány a jejich neomezené generování v aplikaci se na požadavky API nevztahují, takže ho může volat jakýkoli účet Mage s Gems.
Můžu výstupy z API používat komerčně?
Ano. Obsah, který v Mage vytvoříš, včetně toho z API a MCP serveru, můžeš používat komerčně. Uvedení autora oceníme, ale není povinné.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.

Získat API klíčČíst dokumentaci k SDK