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

Mage API · Pro tvůj další nápad

Jedno API. Nekonečné možnosti.

Přenes to nejlepší z Mage do svého produktu i do svého AI asistenta. Generuj obrázky, video a audio s jedním API klíčem nebo jedním připojením MCP.

Získat API klíčPřipojit asistentaČíst dokumentaci API
https://api.mage.space/v1

Stručně

Mage nabízí vývojářům REST API na https://api.mage.space/v1 a vzdálený MCP server na https://mcp.mage.space/mcp. Obojí pohání stejných 28 modelů pro obrázky, video a audio, včetně exkluzivních modelů Mage Mango 3 a Cherry 2 Pro, na jednom účtu. Každé generování se platí v Gems, bez předplatného.

  • 28Modely
  • 3Typy médií
  • 16Nástroje MCP
  • $0Měsíční poplatek

Možnosti připojení

Volej ho z kódu, od asistenta nebo z ComfyUI

  • REST API

    Mage API

    Odesílej generování z vlastního kódu pomocí klíče. Asynchronní požadavky, idempotentní opakování, nahrávání souborů až 100 MB a 20 souběžných generování.

  • SDK

    SDK pro TypeScript a Python

    Oficiální typované klienty, které na pár řádků odešlou požadavek, počkají na výsledek, bezpečně zopakují volání a nahrají soubory.

  • MCP server

    MCP server Mage

    Připoj Claude, ChatGPT, Claude Code, Grok nebo Cursor pomocí přihlášení a žádej o obrázky, video a audio normální řečí.

  • ComfyUI

    Mage pro ComfyUI

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

Podle typu média

API pro generování

Rychlý start

Tvoje první generování

Vytvoř klíč v API → API Keys, exportuj ho jako MAGE_API_KEY a spusť jeden z těchto příkladů.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "mango-v3"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
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"])

Jak to funguje

Od API klíče k hotovému médiu na tři volání

Všechny modely sdílejí jedno ověřování, jeden asynchronní životní cyklus požadavku a stejné názvy polí.

  1. Vytvoř API klíč

    Přihlas se do Mage, otevři API → API Keys a vytvoř klíč. Začíná na mage_sk_ a zobrazí se jen jednou. Účet může mít 10 aktivních klíčů.

  2. Odešli generování

    Pošli POST s tělem JSON na https://api.mage.space/v1/{model}/generate s hlavičkou Authorization: Bearer. Odpověď přijde okamžitě a obsahuje request_id, status a status_url. Přidej hlavičku Idempotency-Key, aby tě opakování nikdy nestálo platbu navíc.

  3. Zjisti stav a stáhni výsledek

    Dotazuj se na status_url, dokud stav není completed, failed nebo cancelled. Dokončený požadavek obsahuje result.url se souborem obrázku, videa nebo audia, který se uchovává 30 dní.

MCP

Mage ve tvém AI asistentovi

  • Mage v Claude

    Generuj obrázky, video a audio v Claude na webu, v aplikaci pro počítač, v mobilních aplikacích i v Cowork.

  • Mage v ChatGPT

    Generuj obrázky, video a audio v ChatGPT jako osobní aplikaci MCP.

  • Mage v Claude Code

    Generuj obrázky, videa a zvuk v Claude Code přímo v terminálu a editoru.

  • Mage v Grok

    Generuj obrázky, videa a zvuk v Grok jako vlastní konektor.

  • Mage v Cursor

    Generuj obrázky, videa a zvuk v režimu Agent v Cursor.

Modely

Vybrané modely

  • Obrázek · od 40 Gems

    Flux 2 API

    Dlouhé prompty a úpravy s více referencemi

  • Obrázek · od 9 Gems

    GPT Image 2 API

    Přesné prompty a čitelný text

  • Obrázek · od 37 Gems

    Guava API

    Fotorealismus, který projde jako fotografie

  • Obrázek · od 135 Gems

    Mango API

    Naše vlajková řada obrázkových modelů

  • Obrázek · od 51 Gems

    Nano Banana 2 API

    Ostrý, čitelný text až do 4K

  • Video · od 618 Gems

    Cherry API

    Naše vlajková řada video modelů

  • Video · od 245 Gems

    Lemon API

    Všechny video funkce za příznivější cenu

  • Video · od 338 Gems

    Plum API

    Zvuk ke každému klipu, až do 2K

  • Zvuk · od 19 Gems

    Seed Audio API

    Hlasy, hudba a zvukové efekty z jednoho promptu

Stavěné pro ostrý provoz

Co dostane každý požadavek na Mage API

  • Jeden klíč, všechny modely

    28 modelů pro obrázky, video a zvuk za jedním REST API a jedním zůstatkem Gems. Model přepneš změnou cesty v URL.

  • Platíš za každou generaci

    Žádné předplatné ani minimální útrata. Koupíš si Gems a každý požadavek se účtuje podle uvedené ceny. Neúspěšná generace se vrací, pokud ji neblokovaly zásady obsahu Mage.

  • Bezpečné opakování

    Idempotenční klíče zajistí, že opakované odeslání vrátí původní požadavek a nic se neúčtuje podruhé.

  • Konzistentní postavy

    Postavu nebo referenci ulož jednou a pak napiš @handle do libovolného promptu. Použiješ ji s každým modelem, který to podporuje.

  • Velké vstupy

    Obrázky, videa a zvuk můžeš posílat jako URL nebo data URL, případně nahrát soubory do 100 MB přes podepsaný upload.

  • 20 generací najednou

    Každý účet může spustit 20 generací současně a limit lze zvýšit podle tvého případu užití. Odmítnuté požadavky se nikdy neúčtují.

Časté dotazy

Často kladené otázky

Co je Mage API?
Mage API je REST API na https://api.mage.space/v1 pro generování obrázků, videí a zvuku pomocí 28 modelů z tvého vlastního kódu. Požadavky jsou asynchronní a platí se za každou generaci v Gems.
Co je server Mage MCP?
Vzdálený server Model Context Protocol na https://mcp.mage.space/mcp, který AI asistentům umožňuje generovat obrázky, videa a zvuk na tvém účtu Mage. Asistentovi dává 16 nástrojů pro výběr modelu, zjištění ceny, generování, čekání na výsledek a použití tvých uložených postav, referencí a historie.
Potřebuji k používání serveru MCP API klíč?
Ne. Claude, ChatGPT, Grok, Cursor a Claude Code se připojují přihlášením do Mage přes OAuth. API klíč je volitelný, hodí se pro headless nastavení, například CI.
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é.
Jaké jsou limity požadavků?
Účet může mít najednou 20 generací ve frontě nebo ve zpracování. Odeslání nad tento limit je odmítnuto s chybou 429 a nic nestojí. Pokud chceš limit pro svůj případ navýšit, napiš na [email protected].
Může můj AI agent používat Mage API?
Ano. Agenti mohou volat REST API pomocí klíče nebo se připojit k Mage MCP serveru, který Claude, ChatGPT, Claude Code, Grok a Cursor nabízí šestnáct hotových nástrojů pro výběr modelu, zjištění ceny, generování a stažení výsledku. Podívej se na MCP server.
Existuje SDK pro Mage API?
Ano. Oficiální balíček @mage-space/sdk na npm a mage-space na PyPI jsou open source a mají typy pro každý model. Odešlou požadavek, počkají na výsledek, bezpečně zopakují pokusy a nahrají za tebe soubory. Uživatelé ComfyUI si mohou nainstalovat balík nodů comfyui-mage. Podívej se na Mage SDK.
Už používám jiné API pro generování. Co musím změnit?
Nasměruj klienta na https://api.mage.space/v1, posílej svůj klíč Mage jako Bearer token a namapuj svá pole podle stránky modelu: prompt, aspect_ratio, resolution, duration a model_id fungují stejně u všech modelů Mage. Požadavky jsou asynchronní, takže je odešli a pak opakovaně dotazuj status_url.

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íčPřipojit asistenta