API Mage · SDK
Oficjalne SDK do API Mage
Typowane klienty dla TypeScript i Pythona oraz węzły Mage dla ComfyUI. Każdy model obrazów, wideo i audio w kilku linijkach kodu.
W skrócie
Mage publikuje otwartoźródłowe SDK dla swojego API: @mage-space/sdk w npm dla TypeScriptu i JavaScriptu, mage-space w PyPI dla Pythona oraz paczkę węzłów comfyui-mage dla ComfyUI. Każde opakowuje REST API typowanymi konfiguracjami wszystkich 37 modeli, automatycznym odpytywaniem, idempotentnymi ponowieniami i uploadami.
- 3SDK i integracje
- 37Typowane modele
- MITOpen source
- $0Do zainstalowania
Wybierz swoje
SDK i integracje
npm install @mage-space/sdkSDK 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-spaceSDK 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-mageMage 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-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"])W zestawie
Co każde SDK robi za Ciebie
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.
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?
Czy nowe modele Mage działają ze starszym SDK?
Jak SDK chroni przed podwójną opłatą za ponowione żądanie?
Czy SDK są stabilne?
Ile kosztuje Mage API?
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Czy mogę używać wyników z API komercyjnie?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.