Mage SDK · Made for Python

Python SDK
A world of possibilities.

From your first script to your next big idea. Create images, video, and audio with a simple Python client. Sync or async. Always Mage.

Explore the playground Read the guide

One account. Every way to create.

From idea to first request.

Install. Add your key. Make something extraordinary.

View source

Make yourself at home

Install the official Python SDK. Python 3.10 or later, with both sync and async clients.

pip install mage-space

Your key to create

Create an API key and set it in your environment. Keep it on your server. Every request uses your Mage Gems balance.

export MAGE_API_KEY="mage_sk_..."

Let your imagination run

One call submits your request, waits for the result, and returns your finished creation. Download anything you want to keep within 30 days.

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

Explore the Python guide

Uploads, saved characters, retries, and more.

Create

Assets

Profile

Python SDK
A world of possibilities.

From idea to first request.

Make yourself at home

Your key to create

Let your imagination run

Python SDKA world of possibilities.

From idea to first request.

Make yourself at home

Your key to create

Let your imagination run

Python SDK
A world of possibilities.