Treci la conținut
PlaygroundDocumentațieObține cheia API

API Mage · SDK-uri

SDK-uri oficiale pentru API-ul Mage

Clienți tipizați pentru TypeScript și Python și noduri Mage pentru ComfyUI. Toate modelele de imagini, video și audio în câteva linii de cod.

Obține o cheie APICitește documentația SDK

Pe scurt

Mage publică SDK-uri open-source pentru API-ul său: @mage-space/sdk pe npm pentru TypeScript și JavaScript, mage-space pe PyPI pentru Python și pachetul de noduri comfyui-mage pentru ComfyUI. Fiecare învelește API-ul REST cu configurații tipizate pentru toate cele 28 de modele, polling automat, reîncercări idempotente și încărcări de fișiere.

  • 3SDK-uri și integrări
  • 28Modele tipizate
  • MITOpen source
  • $0De instalat

Alege-l pe al tău

SDK-uri și integrări

  • npm install @mage-space/sdk

    SDK TypeScript

    Generează imagini, video și audio din Node.js, cu configurații tipizate pentru fiecare model Mage. Un singur apel trimite cererea, așteaptă și returnează rezultatul.

  • pip install mage-space

    SDK Python

    Generează imagini, video și audio din Python, cu clienți sync și asyncio și configurații tipizate pentru fiecare model Mage.

  • comfy node install comfyui-mage

    Mage pentru ComfyUI

    Mango, Cherry, Seed Audio și toate celelalte modele Mage, ca noduri ComfyUI. Fără GPU, fără descărcări de modele.

Pornire rapidă

Prima ta generare cu un SDK

Instalează pachetul, exportă MAGE_API_KEY și rulează un model.

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-v3',
});

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-v3",
})

print(request["result"]["url"])

Integrat

Ce face fiecare SDK pentru tine

  • Un apel, conținut media gata

    run trimite cererea de generare, face polling cu backoff-ul recomandat de API și se rezolvă cu cererea finalizată, împreună cu result.url.

  • Reîncercări care nu se plătesc de două ori

    Fiecare trimitere poartă o cheie de idempotență. Erorile de rețea și de server sunt reîncercate cu backoff, iar o trimitere reîncercată nu este taxată niciodată a doua oară.

  • Încărcări dintr-un singur apel

    Fișierele prea mari pentru un URL de date trec printr-o încărcare semnată, iar tichetul, PUT-ul și verificarea dimensiunii sunt gestionate pentru tine.

  • Erori clare

    Refuzurile API includ statusul HTTP, codul de eroare și ID-ul cererii; generările eșuate sau anulate și expirările de timp au propriile tipuri de erori.

Pachete

Unde le găsești

SDKPachetInstalareSursă
SDK TypeScript@mage-space/sdknpm install @mage-space/sdkGitHub
SDK Pythonmage-spacepip install mage-spaceGitHub
Mage pentru ComfyUIcomfyui-magecomfy node install comfyui-mageGitHub

Întrebări frecvente

Întrebări frecvente

Sunt SDK-urile Mage gratuite și open source?
Da. SDK-urile și nodurile ComfyUI au licență MIT pe GitHub, iar instalarea lor este gratuită. Plătești doar generările pe care le rulezi, în Gems, la prețul afișat pentru fiecare model.
Funcționează modelele Mage noi cu un SDK mai vechi?
Da. Transmite id-ul noului model ca șir de caractere și rulează; SDK-ul verifică configurația față de câmpurile comune tuturor modelelor. Un bot actualizează tipurile ori de câte ori se schimbă referința API, așa că modelele noi apar cu propriile tipuri în versiunea următoare.
Cum evită SDK-urile să plătești de două ori pentru o cerere reîncercată?
Fiecare trimitere conține un Idempotency-Key. SDK-ul creează o cheie nouă pentru fiecare apel și o reutilizează când reia el însuși acel apel, așa că o trimitere reîncercată returnează cererea inițială și nu se taxează nimic.
Sunt SDK-urile stabile?
Sunt în beta, la versiunea 0.x, așa că o versiune minoră le mai poate modifica. API-ul în sine are versiuni separate și rămâne stabil în cadrul v1.
Cât costă API-ul Mage?
Nu există abonament sau taxă lunară. Fiecare generare se plătește în Gems, la prețul afișat al modelului, iar 1.000 de Gems costă 1 $ la pachetul standard. Pagina fiecărui model afișează prețul cu setările implicite, iar fiecare răspuns indică taxarea exactă. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este. O cerere pe care soldul tău nu o poate acoperi este refuzată înainte de orice taxare.
Am nevoie de un abonament Mage ca să folosesc API-ul?
Nu. API-ul funcționează exclusiv cu Gems. Planurile de abonament și generarea nelimitată din aplicație nu se aplică cererilor API, deci orice cont Mage cu Gems îl poate apela.
Pot folosi rezultatele din API în scop comercial?
Da. Conținutul creat cu Mage, inclusiv prin API și serverul MCP, poate fi folosit în scop comercial. Menționarea sursei este apreciată, dar nu este obligatorie.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.

Obține o cheie APICitește documentația SDK