Mage Python SDK

ดูแบบเร็ว ๆ

Mage Python SDK คือไคลเอนต์โอเพนซอร์สอย่างเป็นทางการสำหรับ Mage API เผยแพร่ในชื่อ mage-space ติดตั้งด้วย "pip install mage-space" ตั้งค่า MAGE_API_KEY แล้วเรียก mage.run พร้อมระบุ model id และคอนฟิก เพื่อรับภาพ วิดีโอ หรือเสียงที่เสร็จแล้วจากโมเดลใดก็ได้ใน 28 โมเดล ใช้ได้กับ Python 3.10 ขึ้นไป และทุกการสร้างจ่ายด้วย Gems

• 3.10+

  Python

• httpx

  HTTP client

• 28

  โมเดลแบบ typed

• MIT

  โอเพนซอร์ส

การตั้งค่า

ติดตั้ง Python SDK และรันโมเดล

1. 01

   ติดตั้งแพ็กเกจ

   เพิ่ม mage-space ลงในโปรเจกต์ของคุณ

   pip install mage-space

2. 02

   ตั้งค่า API key

   สร้างคีย์ที่ API → API Keys บน mage.space แล้ว export ไว้ ไคลเอนต์จะอ่านค่าจาก MAGE_API_KEY

   export MAGE_API_KEY="mage_sk_..."

3. 03

   สร้าง

   เรียก run พร้อม id ของโมเดลและค่ากำหนด ระบบจะรอผลลัพธ์แล้วส่งกลับมา โดยไฟล์ผลลัพธ์อยู่ที่ 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