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

API Mage · Creat pentru următoarea ta idee

Un singur API. Posibilități nesfârșite.

Adu tot ce are Mage mai bun în produsul tău și în asistentul tău AI. Generează imagini, video și audio cu o singură cheie API sau o singură conexiune MCP.

Obține o cheie APIConectează-ți asistentulCitește documentația API
https://api.mage.space/v1

Pe scurt

Mage le oferă dezvoltatorilor un API REST la https://api.mage.space/v1 și un server MCP la distanță la https://mcp.mage.space/mcp. Ambele rulează aceleași 28 de modele pentru imagini, video și audio, inclusiv Mango 3 și Cherry 2 Pro, exclusive Mage, pe un singur cont, iar fiecare generare se plătește în Gems, fără abonament.

  • 28Modele
  • 3Tipuri de media
  • 16Instrumente MCP
  • $0Taxă lunară

Moduri de acces

Apelează-l din cod, din asistentul tău sau din ComfyUI

  • API REST

    API-ul Mage

    Trimite generări din propriul cod, cu o cheie. Cereri asincrone, reîncercări idempotente, încărcări de până la 100 MB și 20 de generări simultane.

  • SDK-uri

    SDK-uri TypeScript și Python

    Clienți oficiali, tipizați, care trimit cererea, așteaptă rezultatul, reîncearcă în siguranță și încarcă fișiere în doar câteva linii.

  • Server MCP

    Serverul MCP Mage

    Conectează Claude, ChatGPT, Claude Code, Grok sau Cursor printr-o autentificare și cere imagini, video și audio cu cuvinte simple.

  • ComfyUI

    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.

După tipul de media

API-uri de generare

Pornire rapidă

Prima ta generare

Creează o cheie în API → API Keys, exportă-o ca MAGE_API_KEY și rulează unul dintre exemplele de mai jos.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "mango-v3"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
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"])

Cum funcționează

De la cheia API la media gata în trei apeluri

Toate modelele folosesc aceeași schemă de autentificare, același ciclu de viață asincron al cererilor și aceleași nume de câmpuri.

  1. Creează o cheie API

    Autentifică-te în Mage, deschide API → API Keys și creează o cheie. Începe cu mage_sk_ și este afișată o singură dată. Un cont poate avea 10 chei active.

  2. Trimite o generare

    Trimite cu POST un corp JSON la https://api.mage.space/v1/{model}/generate, cu un antet Authorization: Bearer. Răspunsul vine imediat, cu un request_id, un status și un status_url. Trimite un antet Idempotency-Key, ca o reîncercare să nu fie plătită de două ori.

  3. Interoghează și descarcă

    Interoghează status_url până când statusul devine completed, failed sau cancelled. O cerere finalizată conține result.url cu fișierul de imagine, video sau audio, păstrat 30 de zile.

MCP

Mage în asistentul tău AI

  • Mage în Claude

    Generează imagini, video și audio în Claude pe web, în aplicația desktop, în aplicațiile mobile și în Cowork.

  • Mage în ChatGPT

    Generează imagini, video și audio în ChatGPT, ca aplicație MCP personală.

  • Mage în Claude Code

    Generează imagini, video și audio în Claude Code, direct în terminal și în editor.

  • Mage în Grok

    Generează imagini, video și audio în Grok, ca;conector personalizat.

  • Mage în Cursor

    Generează imagini, video și audio în modul Agent din Cursor.

Modele

Modele recomandate

  • Imagine · de la 40 de Gems

    API Flux 2

    Prompturi lungi și editări cu mai multe referințe

  • Imagine · de la 9 Gems

    API GPT Image 2

    Prompturi precise și text lizibil

  • Imagine · de la 37 de Gems

    API Guava

    Fotorealism care trece drept fotografie

  • Imagine · de la 135 de Gems

    API Mango

    Familia noastră principală de modele de imagine

  • Imagine · de la 51 de Gems

    API Nano Banana 2

    Text clar și lizibil, până la 4K

  • Video · de la 618 Gems

    API Cherry

    Familia noastră principală de modele video

  • Video · de la 245 de Gems

    API Lemon

    Toate funcțiile video, la un preț mai prietenos

  • Video · de la 338 de Gems

    API Plum

    Sunet pe fiecare clip, până la 2K

  • Audio · de la 19 Gems

    API Seed Audio

    Voci, muzică și efecte sonore dintr-un singur prompt

Creat pentru producție

Ce primește fiecare cerere către API-ul Mage

  • O cheie, toate modelele

    28 de modele de imagine, video și audio într-un singur API REST și cu un singur sold de Gems. Schimbi modelul modificând calea din URL.

  • Plătești per generare

    Fără abonament și fără cheltuială minimă. Cumperi Gems, iar fiecare cerere costă prețul afișat. O generare eșuată este rambursată, cu excepția cazului în care a fost blocată de politica de conținut Mage.

  • Reîncercări în siguranță

    Cheile de idempotență fac ca o retrimitere să returneze cererea inițială, fără o nouă taxare.

  • Personaje consecvente

    Salvează o dată un personaj sau o referință, apoi scrie @handle în orice prompt ca să le folosești cu fiecare model care le acceptă.

  • Fișiere de intrare mari

    Trimite imagini, video și audio ca URL-uri sau URL-uri de date, sau încarcă fișiere de până la 100 MB printr-o încărcare semnată.

  • 20 de generări simultane

    Fiecare cont poate rula 20 de generări în același timp, iar limita poate fi mărită pentru cazul tău de utilizare. Cererile refuzate nu sunt taxate niciodată.

Întrebări frecvente

Întrebări frecvente

Ce este API-ul Mage?
API-ul Mage este un API REST la https://api.mage.space/v1 pentru a genera imagini, video și audio cu 28 de modele direct din codul tău. Cererile sunt asincrone și se plătesc per generare, în Gems.
Ce este serverul MCP Mage?
Un server Model Context Protocol la distanță, la https://mcp.mage.space/mcp, prin care asistenții AI pot genera imagini, video și audio în contul tău Mage. Oferă asistentului 16 instrumente pentru a alege un model, a afla prețul, a genera, a aștepta rezultatul și a folosi personajele, referințele și istoricul tău salvate.
Am nevoie de o cheie API ca să folosesc serverul MCP?
Nu. Claude, ChatGPT, Grok, Cursor și Claude Code se conectează prin autentificare în Mage cu OAuth. Cheia API este opțională, pentru configurări headless, cum ar fi CI.
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.
Care sunt limitele de utilizare?
Un cont poate avea simultan 20 de generări în coadă sau în curs. O trimitere peste această limită este refuzată cu 429 și nu costă nimic. Scrie la [email protected] pentru a crește limita pentru cazul tău de utilizare.
Poate agentul meu AI să folosească API-ul Mage?
Da. Agenții pot apela API-ul REST cu o cheie sau se pot conecta la serverul MCP Mage, care oferă Claude, ChatGPT, Claude Code, Grok și Cursor șaisprezece instrumente gata făcute pentru alegerea unui model, afișarea prețului, generare și preluarea rezultatului. Vezi serverul MCP.
Există un SDK pentru API-ul Mage?
Da. Pachetul oficial @mage-space/sdk de pe npm și mage-space de pe PyPI sunt open source și tipizate pentru fiecare model. Trimit cererea, așteaptă rezultatul, reîncearcă în siguranță și încarcă fișiere în locul tău. Utilizatorii ComfyUI pot instala pachetul de noduri comfyui-mage. Vezi SDK-urile Mage.
Folosesc deja alt API de generare. Ce trebuie să schimb?
Îndreaptă clientul către https://api.mage.space/v1, trimite cheia Mage ca token Bearer și asociază-ți câmpurile cu pagina modelului: prompt, aspect_ratio, resolution, duration și model_id funcționează la fel pentru toate modelele Mage. Cererile sunt asincrone, așa că trimite cererea și apoi interoghează periodic status_url.

Î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 APIConectează-ți asistentul