Mage Python SDK'sı

Bir bakışta

Mage Python SDK'sı, Mage API'nin mage-space adıyla yayımlanan resmî, açık kaynaklı istemcisidir. "pip install mage-space" komutuyla kur, MAGE_API_KEY değişkenini ayarla ve bir model kimliği ile yapılandırmayla mage.run çağırarak 28 modelden herhangi biriyle hazır görsel, video veya ses al. Python 3.10 veya üzerinde çalışır ve her üretim Gems ile ödenir.

• 3.10+

  Python

• httpx

  HTTP istemcisi

• 28

  Tip tanımlı modeller

• MIT

  Açık kaynak

Kurulum

Python SDK'sını kur ve bir model çalıştır

1. 01

   Paketi kur

   mage-space paketini projene ekle.

   pip install mage-space

2. 02

   API anahtarını ayarla

   mage.space'te API → API Keys bölümünden bir anahtar oluştur ve dışa aktar. İstemci MAGE_API_KEY değerini okur.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Üret

   run fonksiyonunu bir model kimliği ve yapılandırmasıyla çağır. Sonucu bekler ve döndürür; çıktı result.url adresindedir.

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

Örnekler

Python SDK'sı kullanımda

Her örnek, MAGE_API_KEY değerini okuyan bir istemciyle başlar.

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)

Neden SDK

SDK senin için neleri halleder

Referans

Python SDK'sına kısa bakış

Aynı yöntemler her modeli kapsar; model ilk argümandır.

Modeller

Bu modellerle başla

SSS

Sık sorulan sorular

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

İlgili

• Mage SDK'ları
• Mage TypeScript SDK
• ComfyUI için Mage
• PyPI'da mage-space
• Tüm API modelleri
• API dokümantasyonu