Python SDK Mage

W skrócie

Python SDK Mage to oficjalny klient API Mage typu open source, dostępny jako mage-space. Zainstaluj go poleceniem "pip install mage-space", ustaw MAGE_API_KEY i wywołaj mage.run z identyfikatorem modelu i konfiguracją, aby otrzymać gotowe obrazy, wideo lub audio z dowolnego z 28 modeli. Działa na Pythonie 3.10 lub nowszym, a każda generacja jest płatna w Gems.

• 3.10+

  Python

• httpx

  Klient HTTP

• 28

  Typowane modele

• MIT

  Open source

Konfiguracja

Zainstaluj Python SDK i uruchom model

1. 01

   Zainstaluj pakiet

   Dodaj mage-space do swojego projektu.

   pip install mage-space

2. 02

   Ustaw klucz API

   Utwórz klucz w API → API Keys na mage.space i wyeksportuj go. Klient odczytuje MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Generuj

   Wywołaj run z ID modelu i jego konfiguracją. Metoda czeka na wynik i go zwraca; wynik znajdziesz w result.url.

   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"])

Przykłady

Python SDK w praktyce

Każdy przykład zaczyna się od klienta, który odczytuje MAGE_API_KEY.

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

submitted = mage.generate("cherry", {
    "prompt": "Waves rolling onto a black sand beach at sunset",
    "resolution": "720p",
    "duration": "5",
})

final = mage.requests.wait(
    submitted["request_id"],
    timeout=900,
    on_update=lambda request: print(request["status"]),
)

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

clip = mage.uploads.upload("clip.mp4")  # a path, bytes, or a binary file

mage.run("cherry", {
    "prompt": "Restyle this clip as a watercolor painting",
    "videos": [clip["url"]],
})

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

mage.characters.create(
    name="Ana",
    handle="ana",
    image="https://example.com/ana.png",
)

mage.run("mango", {"prompt": "@ana walking through a night market"})

from mage_space import Mage, MageAPIError, MageGenerationError

mage = Mage()  # reads MAGE_API_KEY

try:
    mage.run("mango", {"prompt": "A lighthouse at night"})
except MageAPIError as error:
    if error.code == "insufficient_gems":
        print("Gems needed:", error.body["error"]["gems_required"])
    else:
        raise
except MageGenerationError as error:
    print("No output:", error.code)

Dlaczego SDK

Co SDK robi za ciebie

Dokumentacja

Python SDK w skrócie

Te same metody obsługują każdy model; model jest pierwszym argumentem.

Modele

Zacznij od tych modeli

FAQ

Najczęściej zadawane pytania

Zacznij tworzyć z Mage

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

Powiązane

• SDK Mage
• Mage TypeScript SDK
• Mage dla ComfyUI
• mage-space w PyPI
• Wszystkie modele API
• Dokumentacja API