Przejdź do treści

API Mage · Generowanie obrazów

API do generowania obrazów AI dla każdego modelu

Tekst na obraz, edycja obrazów i spójne postacie z 18 modeli, w tym flagowego Mango 4 od Mage, przez jeden klucz i jedno saldo.

POST https://api.mage.space/v1/{model}/generate

W skrócie

Mage API do generowania obrazów to REST API pod adresem https://api.mage.space/v1, które uruchamia 18 modeli tekst na obraz i do edycji obrazów, w tym Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 i Krea 2. Wysyłasz prompt metodą POST na /{model}/generate, sprawdzasz status żądania i pobierasz obraz. Każdy obraz jest płatny w Gems, bez subskrypcji.

  • 18modeli obrazów
  • $0.009Najtańsza cena domyślna za obraz
  • 20Równoczesne generowania
  • $0Opłata miesięczna

Modele

Wszystkie modele obrazów w API Mage

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.

ModelNajlepszy doWartości model_idCena domyślna
AnimaStworzony specjalnie do animeanima-v120 Gems ($0.02)
ChromaOtwarte wagi, oparty na Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Długie prompty i edycje z wieloma referencjamiflux2-dev40 Gems ($0.04)
GPT Image 2Precyzyjne prompty i czytelny tekstgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine w dwóch wersjachgrok-imagine-image, grok-imagine-image-2.090 Gems ($0.09)
GuavaFotorealizm nie do odróżnienia od zdjęciaguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamSzybki i wszechstronny, z negatywnymi promptamihidream-fast20 Gems ($0.02)
Krea 2Piękna estetyka w kilka sekundkrea-2-turbo20 Gems ($0.02)
MangoNasza flagowa rodzina modeli obrazówmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v442 Gems ($0.042)
MiniMax H3 ImageNatywne obrazy 16 megapikseli, otwarte wagiminimax-h3-image15 Gems ($0.015)
MOSS-ImageDługie prompty i tekst dwujęzyczny, otwarte wagimoss-image25 Gems ($0.025)
Nano Banana 2Ostry, czytelny tekst, do 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL z poprawionymi twarzami i dłońmi6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
SeedreamSeedream, ze ścisłym filtremseedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.542 Gems ($0.042)
Stable Diffusion v1.5Klasyk w przystępnej cenie15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeStable Diffusion, który najlepiej słucha poleceńsd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL dostrojony do fotorealizmu6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageNajszybszy model obrazów w Magez-image-turbo10 Gems ($0.01)

Szybki start

Wygeneruj obraz z Anima v1

Ustaw MAGE_API_KEY, wyślij żądanie i odpytuj, aż generowanie się zakończy. Zamień anima w adresie URL na dowolny model z powyższych.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

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.

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.

Zastosowania

Co deweloperzy budują z API obrazów

  • Obrazy produktowe i marketingowe

    Twórz zdjęcia produktów, warianty reklam i posty do social mediów na żądanie, z czytelnym tekstem dzięki GPT Image 2.6 lub Nano Banana 2.

  • Spójne postacie

    Zapisz postać raz i zachowaj tę samą twarz w całej serii z Mango 4, Guava 2 Pro i innymi modelami, które obsługują wzmianki @handle.

  • Pipeline'y edycji obrazów

    Wyślij obraz źródłowy z instrukcją, a zmienimy dokładnie to, o co prosisz, i zostawimy resztę bez zmian.

  • Aplikacje i gry

    Generuj awatary, naklejki, karty i sceny w swoim produkcie bez utrzymywania ani jednego GPU.

  • Fotorealistyczne portrety

    Guava 2 Pro tworzy portrety, zdjęcia modowe i lifestyle'owe z wiernie odwzorowaną skórą, tkaninami i światłem.

  • Szybkie szkice na dużą skalę

    Z-Image Turbo i Krea 2 utrzymują niskie ceny miniatur i pierwszych wersji w dużych ilościach.

FAQ

Najczęściej zadawane pytania

Jakie jest najlepsze API do generowania obrazów AI?
To zależy od zadania. W Mage Mango 4 to domyślny wybór do większości obrazów: dokładnie wykonuje polecenia, zachowuje spójność postaci i edytuje obraz, nie ruszając reszty. Guava 2 Pro najlepiej sprawdza się w fotorealizmie, GPT Image 2.6 i Nano Banana 2 w tekście na obrazach, a Z-Image Turbo lub Krea 2 w szybkich, tanich szkicach. Wszystkie działają przez to samo API.
Czy API obrazów obsługuje edycję obrazów i obrazy referencyjne?
Tak. Modele, które przyjmują obrazy, odbierają je w polach image i additional_images jako adresy URL, data URL lub przesłane pliki. Strona każdego modelu podaje jego dane wejściowe i liczbę obsługiwanych obrazów referencyjnych.
Jakie rozdzielczości obsługuje API obrazów?
To zależy od modelu: 1K i 2K w większości modeli, 3K w Mango 3S i do 4K w Mango 2 oraz Nano Banana 2. Strona każdego modelu podaje dostępne rozdzielczości i proporcje obrazu.
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ść