W skrócie
Mage API uruchamia 15 modeli obrazu, 12 modeli wideo i 1 model audio pod adresem https://api.mage.space/v1/{model}/generate. Każdy model korzysta z tego samego klucza, cyklu żądania i nazw pól, a płacisz za każde generowanie w Gems.
15
Modele obrazu
12
Modele wideo
1
Modele audio
1
Jeden klucz API do wszystkich
Modele obrazu
Modele do generowania obrazów
Ceny są za jedno generowanie, w Gems. 1000 Gems kosztuje 1 USD w standardowym pakiecie, a większe pakiety dodają bonusowe Gems. Cena zależy od modelu, rozdzielczości i czasu trwania; pokazujemy cenę dla ustawień domyślnych, a dokładną opłatę podaje każda odpowiedź w billing.gems_charged. Nieudane generowanie jest zwracane; zablokowane przez zasady treści Mage — nie.
| Model | Najlepszy do | Wartości model_id | Cena domyślna |
|---|---|---|---|
| Anima | Stworzony specjalnie do anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Otwarte wagi, oparty na Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Długie prompty i edycje z wieloma referencjami | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Precyzyjne prompty i czytelny tekst | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine w trzech poziomach jakości | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Fotorealizm nie do odróżnienia od zdjęcia | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Szybki i wszechstronny, z negatywnymi promptami | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Piękna estetyka w kilka sekund | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Nasza flagowa rodzina modeli obrazów | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Ostry, czytelny tekst, do 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL z poprawionymi twarzami i dłońmi | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | Klasyk w przystępnej cenie | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion, który najlepiej słucha poleceń | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL dostrojony do fotorealizmu | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Najszybszy model obrazów w Mage | z-image-turbo | 10 Gems ($0.01) |
Modele wideo
Modele do generowania wideo
| Model | Najlepszy do | Wartości model_id | Cena domyślna |
|---|---|---|---|
| Berry | Wideo wierne Twoim referencjom | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Ustal pierwszą i ostatnią klatkę | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Nasza flagowa rodzina modeli wideo | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine w ruchu | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Wideo na co dzień, bez konfiguracji | kiwi | 270 Gems ($0.27) |
| Lemon | Wszystkie funkcje wideo w przystępniejszej cenie | lemon | 245 Gems ($0.245) |
| LTX Video | Szybkie wideo z otwartymi wagami do iteracji | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime w ruchu, opcjonalnie z dźwiękiem | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Szybkie otwarte wideo z dźwiękiem stereo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Dźwięk w każdym klipie, do 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Postacie ożywione z pierwszej klatki | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Wideo z otwartymi wagami z wariantem Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Modele audio
Modele do generowania dźwięku
| Model | Najlepszy do | Wartości model_id | Cena domyślna |
|---|---|---|---|
| Seed Audio | Głosy, muzyka i efekty dźwiękowe z jednego promptu | seed-audio-1.0 | 19 Gems ($0.019) |
FAQ
Najczęściej zadawane pytania
Ile kosztuje Mage API?
Nie ma subskrypcji ani opłaty miesięcznej. Każda generacja jest płatna w Gems według ceny danego modelu, a 1000 Gems kosztuje 1 USD w standardowym pakiecie. Strona każdego modelu podaje cenę przy ustawieniach domyślnych, a każda odpowiedź zawiera dokładną kwotę opłaty. Za nieudaną generację zwracamy koszt, ale nie w przypadku zablokowania jej przez politykę treści Mage. Zapytanie, na które nie wystarcza Twojego salda, zostanie odrzucone, zanim cokolwiek zostanie pobrane.
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Nie. API działa wyłącznie na Gems. Plany członkowskie i ich nielimitowane generowanie w aplikacji nie dotyczą zapytań API, więc może z niego korzystać każde konto Mage z Gems.
Czy mogę używać wyników z API komercyjnie?
Tak. Treści tworzone w Mage, także przez API i serwer MCP, możesz wykorzystywać komercyjnie. Podanie autorstwa jest mile widziane, ale nie jest wymagane.
Jakie obowiązują limity zapytań?
Na jednym koncie może być jednocześnie w kolejce lub w trakcie 20 generowań. Zgłoszenie ponad limit zostanie odrzucone z kodem 429 i nic nie kosztuje. Napisz na [email protected], aby podnieść limit dla swojego zastosowania.
Czy mój agent AI może korzystać z API Mage?
Tak. Agenci mogą wywoływać REST API za pomocą klucza albo połączyć się z serwerem MCP Mage, który daje Claude, ChatGPT, Claude Code, Grok i Cursor szesnaście gotowych narzędzi do wyboru modelu, sprawdzenia ceny, generowania i pobrania wyniku. Zobacz serwer MCP.
Czy istnieje SDK do API Mage?
Tak. Oficjalne pakiety @mage-space/sdk na npm i mage-space na PyPI są open source i mają typy dla każdego modelu. Wysyłają zlecenia, czekają na wynik, bezpiecznie ponawiają próby i przesyłają za Ciebie pliki. Użytkownicy ComfyUI mogą zainstalować zestaw węzłów comfyui-mage. Zobacz SDK Mage.
Korzystam już z innego API do generowania. Co muszę zmienić?
Skieruj klienta na https://api.mage.space/v1, wysyłaj swój klucz Mage jako token Bearer i dopasuj pola do strony modelu: prompt, aspect_ratio, resolution, duration i model_id działają tak samo we wszystkich modelach Mage. Żądania są asynchroniczne, więc wyślij je, a potem odpytuj status_url.
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.