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

Mage API · Generování obrázků

API pro generování obrázků pomocí AI pro každý model

Text na obrázek, úpravy obrázků a konzistentní postavy z 15 modelů, včetně vlajkového Mango 3 od Mage, přes jeden klíč a jeden zůstatek.

Získat API klíčČíst dokumentaci API
POST https://api.mage.space/v1/{model}/generate

Stručně

Mage API pro generování obrázků je REST API na https://api.mage.space/v1, které spouští 15 modelů pro převod textu na obrázek a úpravy obrázků, včetně Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 a Krea 2. Pošleš prompt pomocí POST na /{model}/generate, dotazuješ se na stav požadavku a stáhneš obrázek. Každý obrázek se platí v Gems, bez předplatného.

  • 15modelů obrázků
  • $0.009Nejlevnější výchozí cena za obrázek
  • 20Souběžné generace
  • $0Měsíční poplatek

Modely

Všechny modely obrázků v Mage API

Ceny jsou za jedno generování, v Gems. 1 000 Gems stojí 1 $ u standardního balíčku a větší balíčky přidávají bonusové Gems. Cena závisí na modelu, rozlišení a délce; zobrazená je cena s výchozím nastavením a každá odpověď uvádí přesnou částku v billing.gems_charged. Selhané generování se vrací; generování zablokované zásadami obsahu Mage ne.

ModelNejlepší proHodnoty model_idVýchozí cena
AnimaVytvořený přímo pro animeanima-v120 Gems ($0.02)
ChromaOpen-weights, postavený na Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Dlouhé prompty a úpravy s více referencemiflux2-dev40 Gems ($0.04)
GPT Image 2Přesné prompty a čitelný textgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine ve třech úrovních kvalitygrok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.075 Gems ($0.075)
GuavaFotorealismus, který projde jako fotografieguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamRychlý a univerzální, s negativními promptyhidream-fast20 Gems ($0.02)
Krea 2Nádherná estetika během pár sekundkrea-2-turbo20 Gems ($0.02)
MangoNaše vlajková rodina obrázkových modelůmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo135 Gems ($0.135)
Nano Banana 2Ostrý, čitelný text, až do 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL s opravenými obličeji a rukama6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
Stable Diffusion v1.5Klasika za málo peněz15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeStable Diffusion, který poslouchá nejlépesd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL vyladěný na fotorealismus6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageNejrychlejší model obrázků v Magez-image-turbo10 Gems ($0.01)

Rychlý start

Vygeneruj obrázek pomocí Anima v1

Nastav MAGE_API_KEY, odešli požadavek a dotazuj se, dokud se nedokončí. Nahraď anima v URL libovolným modelem výše.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

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í.

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í.

Případy použití

Co vývojáři staví s API pro obrázky

  • Produktové a marketingové obrázky

    Vytvářej produktové fotky, varianty reklam a příspěvky na sociální sítě na požádání, s čitelným textem z GPT Image 2.5 nebo Nano Banana 2.

  • Konzistentní postavy

    Ulož postavu jednou a zachovej stejný obličej v celé sérii s Mango 3, Guava 2 Pro a dalšími modely, které berou zmínky @handle.

  • Pipeline pro úpravu obrázků

    Pošli zdrojový obrázek s instrukcí a změní se přesně to, co požaduješ. Zbytek zůstane na místě.

  • Aplikace a hry

    Generuj avatary, samolepky, karty a scény přímo ve svém produktu, aniž bys musel provozovat jediné GPU.

  • Fotorealistické portréty

    Guava 2 Pro vykresluje portréty, módní a lifestylové snímky s věrnou pokožkou, látkami a světlem.

  • Rychlé návrhy ve velkém

    Z-Image Turbo a Krea 2 udržují nízké ceny u velkého množství náhledů a prvních verzí.

Časté dotazy

Často kladené otázky

Které je nejlepší API pro generování obrázků pomocí AI?
Záleží na úkolu. V Mage je Mango 3 výchozí volbou pro většinu obrázků: drží se přesných instrukcí, udržuje konzistentní postavy a upravuje obrázek, aniž by narušil zbytek. Guava 2 Pro je nejlepší pro fotorealismus, GPT Image 2.5 a Nano Banana 2 pro text v obrázcích a Z-Image Turbo nebo Krea 2 pro rychlé a levné návrhy. Všechny běží přes stejné API.
Podporuje API pro obrázky úpravy obrázků a referenční obrázky?
Ano. Modely, které přijímají obrázky, je berou v polích image a additional_images jako URL, data URL nebo nahrané soubory. Stránka každého modelu uvádí jeho vstupy a kolik referenčních obrázků přijímá.
Jaká rozlišení API pro obrázky podporuje?
Záleží na modelu: 1K a 2K u většiny modelů, 3K u Mango 3S a až 4K u Mango 2 a Nano Banana 2. Stránka každého modelu uvádí dostupná rozlišení a poměry stran.
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íčČíst dokumentaci API