Mage API · Stworzone pod Twój następny pomysł
Jedno API. Nieograniczone możliwości.
Wykorzystaj to, co najlepsze w Mage, w swoim produkcie i asystencie AI. Generuj obrazy, wideo i audio za pomocą jednego klucza API lub jednego połączenia MCP.
https://api.mage.space/v1W skrócie
Mage oferuje deweloperom REST API pod adresem https://api.mage.space/v1 oraz zdalny serwer MCP pod adresem https://mcp.mage.space/mcp. Oba uruchamiają te same 37 modeli obrazów, wideo i dźwięku, w tym dostępne tylko w Mage Mango 4 i Cherry 2 Pro, na jednym koncie, a każda generacja jest płatna w Gems, bez subskrypcji.
- 37Modele
- 3Typy mediów
- 16Narzędzia MCP
- $0Opłata miesięczna
Sposoby dostępu
Używaj z poziomu kodu, asystenta lub ComfyUI
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 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 Mage
Połącz Claude, ChatGPT, Claude Code, Grok lub Cursor po zalogowaniu i proś o obrazy, wideo i audio zwykłymi słowami.
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
API do generowania obrazów AI
Tekst na obraz, edycja i spójne postacie w jakości do 4K.
API do generowania wideo AI
Tekst na wideo, obraz na wideo, klatki, referencje i dźwięk.
API do generowania audio AI
Głosy, narracja, muzyka i efekty dźwiękowe na podstawie promptu.
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-v4"
}' | 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-v4',
});
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-v4",
})
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
Flux 2 API
Długie prompty i edycje z wieloma referencjami
GPT Image 2 API
Precyzyjne prompty i czytelny tekst
Guava API
Fotorealizm, który uchodzi za prawdziwe zdjęcie
Mango API
Nasza flagowa rodzina modeli obrazu
Nano Banana 2 API
Wyraźny, czytelny tekst, do 4K
Cherry API
Nasza flagowa rodzina modeli wideo
Lemon API
Wszystkie funkcje wideo w bardziej przyjaznej cenie
Plum API
Dźwięk w każdym klipie, do 2K
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
Jeden klucz, wszystkie modele
37 modeli do obrazów, wideo i dźwięku w jednym REST API i z jednym saldem Gems. Model zmienisz, zmieniając ścieżkę w URL.
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?
Czym jest serwer MCP Mage?
Czy potrzebuję klucza API, żeby korzystać z serwera MCP?
Ile kosztuje Mage API?
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Czy mogę używać wyników z API komercyjnie?
Jakie obowiązują limity zapytań?
Czy mój agent AI może korzystać z API Mage?
Czy istnieje SDK do API Mage?
Korzystam już z innego API do generowania. Co muszę zmienić?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.