Przejdź do treści

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/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-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źć

SDKPakietInstalacjaŹródło
SDK dla TypeScript@mage-space/sdknpm install @mage-space/sdkGitHub
SDK dla Pythonamage-spacepip install mage-spaceGitHub
Mage dla ComfyUIcomfyui-magecomfy node install comfyui-mageGitHub

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

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

CharactersSpołeczność