Mage Python SDK

एक नज़र में

Mage Python SDK, Mage API का आधिकारिक ओपन सोर्स क्लाइंट है, जो mage-space नाम से प्रकाशित है। "pip install mage-space" से इसे इंस्टॉल करें, MAGE_API_KEY सेट करें और मॉडल id व कॉन्फ़िग के साथ 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 key सेट करें

   mage.space पर API → API Keys में key बनाएँ और उसे export करें। क्लाइंट MAGE_API_KEY पढ़ता है।

   export MAGE_API_KEY="mage_sk_..."

3. 03

   जनरेट करें

   मॉडल id और उसके कॉन्फ़िग के साथ 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 SDKs
• Mage TypeScript SDK
• ComfyUI के लिए Mage
• PyPI पर mage-space
• सभी API मॉडल
• API डॉक्यूमेंटेशन