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}/generateW 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.
| 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, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine w dwóch wersjach | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| 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, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Natywne obrazy 16 megapikseli, otwarte wagi | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Długie prompty i tekst dwujęzyczny, otwarte wagi | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Ostry, czytelny tekst, do 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL z poprawionymi twarzami i dłońmi | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, ze ścisłym filtrem | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| 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) |
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.
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.
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?
Czy API obrazów obsługuje edycję obrazów i obrazy referencyjne?
Jakie rozdzielczości obsługuje API obrazów?
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.