Mage API · Modely
28 generativních modelů, jedno API
Všechny modely pro obrázky, video a zvuk, které Mage API provozuje, s tím, na co se který hodí, jeho hodnotami model_id a cenou při výchozím nastavení.
POST https://api.mage.space/v1/{model}/generateStručně
Mage API provozuje 15 obrazových modelů, 12 video modelů a 1 audio model na https://api.mage.space/v1/{model}/generate. Každý model používá stejný klíč, stejný životní cyklus požadavku a stejné názvy polí a platí se za generování v Gems.
- 15Obrazové modely
- 12Video modely
- 1Audio modely
- 1Jeden API klíč pro všechny
Obrazové modely
Modely pro generování obrázků
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.
| Model | Nejlepší pro | Hodnoty model_id | Výchozí cena |
|---|---|---|---|
| Anima | Vytvořený přímo pro anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, postavený na Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Dlouhé prompty a úpravy s více referencemi | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Přesné prompty a čitelný text | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine ve třech úrovních kvality | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Fotorealismus, který projde jako fotografie | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Rychlý a univerzální, s negativními prompty | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Nádherná estetika během pár sekund | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Naše vlajková rodina obrázkových modelů | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Ostrý, čitelný text, až do 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL s opravenými obličeji a rukama | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | Klasika za málo peněz | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion, který poslouchá nejlépe | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL vyladěný na fotorealismus | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Nejrychlejší model obrázků v Mage | z-image-turbo | 10 Gems ($0.01) |
Video modely
Modely pro generování videa
| Model | Nejlepší pro | Hodnoty model_id | Výchozí cena |
|---|---|---|---|
| Berry | Video věrné tvým referencím | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Zafixuj první a poslední snímek | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Naše vlajková rodina video modelů | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine v pohybu | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video na každý den, bez nastavování | kiwi | 270 Gems ($0.27) |
| Lemon | Všechny video funkce za příznivější cenu | lemon | 245 Gems ($0.245) |
| LTX Video | Rychlé video s otevřenými váhami pro iterace | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime v pohybu s volitelným zvukem | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Rychlé otevřené video se stereo zvukem | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Zvuk v každém klipu, až do 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Postavy ožívají z prvního snímku | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Video s otevřenými váhami a variantou Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Audio modely
Modely pro generování zvuku
| Model | Nejlepší pro | Hodnoty model_id | Výchozí cena |
|---|---|---|---|
| Seed Audio | Hlasy, hudba a zvukové efekty z jednoho promptu | seed-audio-1.0 | 19 Gems ($0.019) |
Časté dotazy
Často kladené otázky
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š.