Jeden klucz, wszystkie modele
28 modeli obrazu, wideo i audio w jednym REST API i z jednym saldem Gems. Model zmienisz, edytując ścieżkę URL.
W skrócie
Mage udostępnia deweloperom REST API pod adresem https://api.mage.space/v1 oraz zdalny serwer MCP pod adresem https://mcp.mage.space/mcp. Oba korzystają z tych samych 28 modeli obrazu, wideo i audio, w tym z dostępnych wyłącznie w Mage Mango 3 i Cherry 2 Pro, na jednym koncie, a każda generacja jest opłacana w Gems bez subskrypcji.
28
Modele
3
Typy mediów
16
Narzędzia MCP
$0
Opłata miesięczna
Sposoby dostępu
Używaj z poziomu kodu, asystenta lub ComfyUI
REST API
Mage API
Wysyłaj generacje z własnego kodu za pomocą klucza. Żądania asynchroniczne, idempotentne ponowienia, przesyłanie plików do 100 MB i 20 generacji w toku.
SDK
SDK dla TypeScript i Pythona
Oficjalne, otypowane klienty, które w kilku linijkach wysyłają żądanie, czekają na wynik, bezpiecznie ponawiają próby i przesyłają pliki.
Serwer MCP
Serwer MCP Mage
Połącz Claude, ChatGPT, Claude Code, Grok lub Cursor po zalogowaniu i proś o obrazy, wideo i audio zwykłymi słowami.
ComfyUI
Mage dla ComfyUI
Mango, Cherry, Seed Audio i każdy inny model Mage jako węzły ComfyUI. Bez GPU i bez pobierania modeli.
Według typu mediów
API do generowania
Szybki start
Twoja pierwsza generacja
Utwórz klucz w API → API Keys, wyeksportuj go jako MAGE_API_KEY i uruchom jeden z poniższych przykładów.
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 działa
Od klucza API do gotowego pliku w trzech wywołaniach
Każdy model korzysta z jednego schematu uwierzytelniania, jednego asynchronicznego cyklu żądania i tych samych nazw pól.
Utwórz klucz API
Zaloguj się do Mage, otwórz API → API Keys i utwórz klucz. Zaczyna się od mage_sk_ i jest wyświetlany tylko raz. Konto może mieć 10 aktywnych kluczy.
Wyślij generację
Wyślij POST z ciałem JSON na https://api.mage.space/v1/{model}/generate z nagłówkiem Authorization: Bearer. Odpowiedź przychodzi od razu i zawiera request_id, status oraz status_url. Dodaj nagłówek Idempotency-Key, aby ponowienie nigdy nie kosztowało podwójnie.
Sprawdzaj status i pobierz plik
Odpytuj status_url, aż status zmieni się na completed, failed lub cancelled. Zakończone żądanie zawiera result.url z plikiem obrazu, wideo lub audio, który jest przechowywany przez 30 dni.
MCP
Mage w Twoim asystencie AI
Mage w Claude
Generuj obrazy, wideo i audio w Claude w przeglądarce, aplikacji desktopowej, aplikacjach mobilnych i w Cowork.
Mage w ChatGPT
Generuj obrazy, wideo i audio w ChatGPT jako osobista aplikacja MCP.
Mage w Claude Code
Generuj obrazy, wideo i audio w Claude Code, w terminalu i edytorze.
Mage w Grok
Generuj obrazy, wideo i audio w Grok jako niestandardowy konektor.
Mage w Cursor
Generuj obrazy, wideo i audio w trybie Agent w Cursor.
Modele
Polecane modele
Obraz · od 40 Gems
Flux 2 API
Długie prompty i edycje z wieloma referencjami
Obraz · od 9 Gems
GPT Image 2 API
Precyzyjne prompty i czytelny tekst
Obraz · od 37 Gems
Guava API
Fotorealizm, który uchodzi za prawdziwe zdjęcie
Obraz · od 135 Gems
Mango API
Nasza flagowa rodzina modeli obrazu
Obraz · od 68 Gems
Nano Banana 2 API
Wyraźny, czytelny tekst, do 4K
Wideo · od 618 Gems
Cherry API
Nasza flagowa rodzina modeli wideo
Wideo · od 245 Gems
Lemon API
Wszystkie funkcje wideo w bardziej przyjaznej cenie
Wideo · od 338 Gems
Plum API
Dźwięk w każdym klipie, do 2K
Audio · od 19 Gems
Seed Audio API
Głosy, muzyka i efekty dźwiękowe z jednego promptu
Stworzone do produkcji
Co dostaje każde zapytanie do Mage API
Płać za generację
Bez subskrypcji i minimalnych wydatków. Kupujesz Gems, a każde zapytanie kosztuje tyle, ile wskazuje cennik. Za nieudaną generację zwracamy koszt, chyba że zablokowała ją polityka treści Mage.
Bezpieczne ponowienia
Klucze idempotentności sprawiają, że ponowne wysłanie zapytania zwraca oryginalny wynik i nie pobiera opłaty drugi raz.
Spójne postacie
Zapisz postać lub referencję raz, a potem wpisz @handle w dowolnym prompcie, by użyć jej w każdym modelu, który to obsługuje.
Duże dane wejściowe
Przesyłaj obrazy, wideo i audio jako adresy URL lub data URL albo wgrywaj pliki do 100 MB przez podpisany upload.
20 generacji naraz
Każde konto może uruchomić 20 generacji jednocześnie, a limit można zwiększyć na potrzeby Twojego projektu. Odrzucone zapytania nigdy nie są płatne.
FAQ
Najczęściej zadawane pytania
Czym jest Mage API?
Mage API to REST API pod adresem https://api.mage.space/v1, które pozwala generować obrazy, wideo i audio za pomocą 28 modeli bezpośrednio z Twojego kodu. Zapytania są asynchroniczne, a płatność za każdą generację odbywa się w Gems.
Czym jest serwer MCP Mage?
To zdalny serwer Model Context Protocol pod adresem https://mcp.mage.space/mcp, dzięki któremu asystenci AI mogą generować obrazy, wideo i audio na Twoim koncie Mage. Daje asystentowi 16 narzędzi do wyboru modelu, wyceny, generowania, oczekiwania na wynik oraz korzystania z Twoich zapisanych postaci, referencji i historii.
Czy potrzebuję klucza API, żeby korzystać z serwera MCP?
Nie. Claude, ChatGPT, Grok, Cursor i Claude Code łączą się po zalogowaniu do Mage przez OAuth. Klucz API jest opcjonalny i przydaje się w konfiguracjach bez interfejsu, np. w CI.
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.