API di Mage · SDK
SDK ufficiali per l'API di Mage
Client tipizzati per TypeScript e Python, e nodi Mage per ComfyUI. Ogni modello di immagini, video e audio in poche righe di codice.
In breve
Mage pubblica SDK open source per la sua API: @mage-space/sdk su npm per TypeScript e JavaScript, mage-space su PyPI per Python e il pacchetto di nodi comfyui-mage per ComfyUI. Ognuno racchiude l'API REST con configurazioni tipizzate per tutti i 37 modelli, polling automatico, nuovi tentativi idempotenti e caricamenti.
- 3SDK e integrazioni
- 37Modelli tipizzati
- MITOpen source
- $0Per installare
Scegli il tuo
SDK e integrazioni
npm install @mage-space/sdkSDK TypeScript
Genera immagini, video e audio da Node.js con configurazioni tipizzate per ogni modello di Mage. Una sola chiamata invia, attende e restituisce il risultato.
pip install mage-spaceSDK Python
Genera immagini, video e audio da Python con client sincroni e asyncio e configurazioni tipizzate per ogni modello di Mage.
comfy node install comfyui-mageMage per ComfyUI
Mango, Cherry, Seed Audio e tutti gli altri modelli di Mage come nodi ComfyUI. Nessuna GPU, nessun download di modelli.
Guida rapida
La tua prima generazione con un SDK
Installa il pacchetto, esporta MAGE_API_KEY ed esegui un modello.
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
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-v4",
})
print(request["result"]["url"])Già incluso
Cosa gestisce ogni SDK al posto tuo
Una chiamata, contenuto pronto
run invia la generazione, fa polling con il backoff consigliato dall'API e restituisce la richiesta completata con result.url.
Retry che non si pagano mai due volte
Ogni invio include una chiave di idempotenza. Gli errori di rete e del server vengono ritentati con backoff, e un invio ritentato non viene mai addebitato di nuovo.
Upload in una sola chiamata
I file troppo grandi per un data URL passano da un upload firmato, con ticket, PUT e controllo delle dimensioni gestiti al posto tuo.
Errori chiari
I rifiuti dell'API includono stato HTTP, codice di errore e ID della richiesta; generazioni fallite o annullate e timeout hanno tipi di errore dedicati.
Pacchetti
Dove trovarli
| SDK | Pacchetto | Installazione | Codice sorgente |
|---|---|---|---|
| SDK TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK Python | mage-space | pip install mage-space | GitHub |
| Mage per ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Domande frequenti
Gli SDK di Mage sono gratuiti e open source?
I nuovi modelli Mage funzionano con un SDK più vecchio?
Come evitano gli SDK di pagare due volte per una richiesta ripetuta?
Gli SDK sono stabili?
Quanto costa l'API di Mage?
Mi serve un abbonamento a Mage per usare l'API?
Posso usare a fini commerciali i contenuti generati con l'API?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.