Jedno wywołanie, gotowe media
run wysyła generację, odpytuje API z zalecanym przez nie opóźnieniem (backoff) i zwraca ukończone zgłoszenie z result.url.
W skrócie
Mage publikuje open source'owe SDK do swojego API: @mage-space/sdk w npm dla TypeScript i JavaScript, mage-space w PyPI dla Pythona oraz pakiet węzłów comfyui-mage dla ComfyUI. Każde opakowuje REST API typowanymi konfiguracjami dla wszystkich 28 modeli, automatycznym odpytywaniem, idempotentnymi ponowieniami i przesyłaniem plików.
3
SDK i integracje
28
Typowane modele
MIT
Open source
$0
Do zainstalowania
Wybierz swoje
SDK i integracje
npm install @mage-space/sdk
SDK dla TypeScript
Generuj obrazy, wideo i audio z poziomu Node.js dzięki typowanym konfiguracjom każdego modelu Mage. Jedno wywołanie wysyła zadanie, czeka i zwraca wynik.
pip install mage-space
SDK dla Pythona
Generuj obrazy, wideo i audio z poziomu Pythona dzięki klientom sync i asyncio oraz typowanym konfiguracjom każdego modelu Mage.
comfy node install comfyui-mage
Mage dla ComfyUI
Mango, Cherry, Seed Audio i każdy inny model Mage jako węzły ComfyUI. Bez GPU i bez pobierania modeli.
Szybki start
Twoja pierwsza generacja z SDK
Zainstaluj pakiet, wyeksportuj MAGE_API_KEY i uruchom model.
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"])W zestawie
Co każde SDK robi za Ciebie
Ponowienia, które nigdy nie kosztują podwójnie
Każde zgłoszenie ma klucz idempotentności. Błędy sieci i serwera są ponawiane z opóźnieniem (backoff), a ponowione zgłoszenie nigdy nie jest rozliczane drugi raz.
Przesyłanie plików jednym wywołaniem
Pliki zbyt duże na data URL trafiają przez podpisany upload, a bilet, żądanie PUT i sprawdzenie rozmiaru obsługujemy za Ciebie.
Czytelne błędy
Odmowy API zawierają status HTTP, kod błędu i identyfikator żądania, a nieudane lub anulowane generacje i przekroczenia czasu mają własne typy błędów.
Pakiety
Gdzie je znaleźć
| SDK | Pakiet | Instalacja | Źródło |
|---|---|---|---|
| SDK dla TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK dla Pythona | mage-space | pip install mage-space | GitHub |
| Mage dla ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Najczęściej zadawane pytania
Czy SDK Mage są darmowe i open source?
Tak. SDK i węzły ComfyUI mają licencję MIT na GitHubie, a ich instalacja jest darmowa. Płacisz tylko za wykonane generowania, w Gems, według ceny podanej przy każdym modelu.
Czy nowe modele Mage działają ze starszym SDK?
Tak. Przekaż ID nowego modelu jako ciąg znaków, a zostanie uruchomiony; SDK sprawdza jego konfigurację względem pól wspólnych dla wszystkich modeli. Bot aktualizuje typy za każdym razem, gdy zmienia się dokumentacja API, więc nowe modele dostają własne typy w następnym wydaniu.
Jak SDK chroni przed podwójną opłatą za ponowione żądanie?
Każde zgłoszenie zawiera nagłówek Idempotency-Key. SDK tworzy nowy klucz dla każdego wywołania i używa go ponownie, gdy samo ponawia to wywołanie, więc ponowione zgłoszenie zwraca pierwotne żądanie i nic nie kosztuje.
Czy SDK są stabilne?
Są w wersji beta (0.x), więc wersja minor może jeszcze coś w nich zmienić. Samo API ma osobne wersjonowanie i pozostaje stabilne w ramach v1.
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.
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.