Python SDK của Mage

Xem nhanh

Python SDK của Mage là client mã nguồn mở chính thức cho Mage API, được phát hành với tên mage-space. Cài đặt bằng "pip install mage-space", đặt MAGE_API_KEY, rồi gọi mage.run với id mô hình và một cấu hình để nhận ảnh, video hoặc âm thanh hoàn chỉnh từ bất kỳ mô hình nào trong 28 mô hình. SDK chạy trên Python 3.10 trở lên, và mỗi lần tạo đều được trả bằng Gems.

• 3.10+

  Python

• httpx

  HTTP client

• 28

  Mô hình có định kiểu

• MIT

  Mã nguồn mở

Thiết lập

Cài đặt Python SDK và chạy một mô hình

1. 01

   Cài đặt gói

   Thêm mage-space vào dự án của bạn.

   pip install mage-space

2. 02

   Đặt khóa API

   Tạo khóa tại API → API Keys trên mage.space rồi export khóa đó. Ứng dụng khách sẽ đọc MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Tạo

   Gọi run với id mô hình và cấu hình của nó. Lệnh sẽ chờ kết quả rồi trả về; đầu ra nằm ở 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"])

Ví dụ

Python SDK khi sử dụng thực tế

Mỗi ví dụ đều bắt đầu từ một ứng dụng khách đọc 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)

Vì sao nên dùng SDK

Những việc SDK làm giúp bạn

Tham khảo

Python SDK trong một cái nhìn

Cùng một bộ phương thức dùng cho mọi mô hình; mô hình là đối số đầu tiên.

Mô hình

Bắt đầu với các mô hình này

FAQ

Câu hỏi thường gặp

Bắt đầu xây dựng với Mage

Một tài khoản, một số dư Gems, mọi mô hình. Bạn chỉ trả tiền cho những gì mình tạo.

Liên quan

• SDK của Mage
• SDK TypeScript của Mage
• Mage cho ComfyUI
• mage-space trên PyPI
• Tất cả mô hình API
• Tài liệu API