Przejdź do treści

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/v1

W 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

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

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

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

  3. 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 42 Gems

    Mango API

    Nasza flagowa rodzina modeli obrazu

  • Obraz · od 51 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 173 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

  • 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?
Mage API to REST API pod adresem https://api.mage.space/v1 do generowania obrazów, wideo i dźwięku za pomocą 37 modeli z poziomu własnego kodu. Żądania są asynchroniczne, a płacisz za każdą generację 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 Gemach. Plany członkowskie i ich nielimitowane generowanie w aplikacji nie obejmują zapytań API. Konto musi mieć najpierw jedną udaną płatność – za dowolny pakiet Gemów lub plan; Gemy z bonusu za rejestrację działają tylko w aplikacji Mage.
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.

CharactersSpołeczność