حزمة Mage Python SDK

لمحة سريعة

Mage Python SDK هي العميل الرسمي مفتوح المصدر لـ Mage API، ومنشورة باسم mage-space. ثبّتها بالأمر "pip install mage-space"، واضبط MAGE_API_KEY، ثم استدعِ mage.run مع معرّف النموذج والإعدادات لتحصل على صور أو فيديو أو صوت جاهز من أي نموذج من 28 نموذجًا. تعمل على Python 3.10 أو أحدث، وتُدفع تكلفة كل عملية إنشاء بالـ Gems.

• 3.10+

  Python

• httpx

  عميل HTTP

• 28

  نماذج مضبوطة الأنواع

• MIT

  مفتوح المصدر

الإعداد

ثبّت Python SDK وشغّل نموذجًا

1. 01

   ثبّت الحزمة

   أضف mage-space إلى مشروعك.

   pip install mage-space

2. 02

   اضبط مفتاح API

   أنشئ مفتاحًا من API ← API Keys على mage.space ثم صدّره. يقرأ العميل المتغير MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   ابدأ التوليد

   استدعِ run مع معرّف النموذج وإعداداته. ينتظر النتيجة ويعيدها، وتجد المخرجات في 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"])

أمثلة

Python SDK عمليًا

يبدأ كل مثال من عميل يقرأ 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)

لماذا SDK

ما الذي يتولاه SDK عنك

المرجع

Python SDK في لمحة

الدوال نفسها تغطي كل النماذج؛ والنموذج هو المعامل الأول.

النماذج

ابدأ بهذه النماذج

الأسئلة الشائعة

الأسئلة الشائعة

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

ذات صلة

• حزم Mage SDK
• Mage TypeScript SDK
• Mage لـ ComfyUI
• mage-space على PyPI
• جميع نماذج API
• وثائق API