L'SDK Python di Mage

In breve

L'SDK Python di Mage è il client ufficiale e open source per l'API di Mage, pubblicato come mage-space. Installalo con "pip install mage-space", imposta MAGE_API_KEY e chiama mage.run con un ID modello e una configurazione per ottenere immagini, video o audio già pronti da uno qualsiasi dei 28 modelli. Funziona con Python 3.10 o successivo e ogni generazione si paga in Gems.

• 3.10+

  Python

• httpx

  Client HTTP

• 28

  Modelli tipizzati

• MIT

  Open source

Configurazione

Installa l'SDK Python ed esegui un modello

1. 01

   Installa il pacchetto

   Aggiungi mage-space al tuo progetto.

   pip install mage-space

2. 02

   Imposta la tua chiave API

   Crea una chiave in API → API Keys su mage.space ed esportala. Il client legge MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Genera

   Chiama run con l'id di un modello e la sua configurazione. Attende il risultato e lo restituisce; l'output si trova in 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"])

Esempi

L'SDK Python in pratica

Ogni esempio parte da un client che legge 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)

Perché l'SDK

Cosa fa l'SDK al posto tuo

Riferimento

L'SDK Python in breve

Gli stessi metodi valgono per ogni modello; il modello è il primo argomento.

Modelli

Inizia con questi modelli

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• SDK di Mage
• SDK TypeScript di Mage
• Mage per ComfyUI
• mage-space su PyPI
• Tutti i modelli API
• Documentazione API