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

API Mage · Generare de imagini

API-ul de generare de imagini AI pentru toate modelele

Text în imagine, editare de imagini și personaje consecvente de la 15 modele, inclusiv Mango 3, modelul-vedetă Mage, cu o singură cheie și un singur sold.

Obține o cheie APICitește documentația API
POST https://api.mage.space/v1/{model}/generate

Pe scurt

API-ul Mage de generare de imagini este un API REST la https://api.mage.space/v1 care rulează 15 modele de text în imagine și de editare de imagini, printre care Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 și Krea 2. Trimiți un prompt cu POST la /{model}/generate, interoghezi cererea și descarci imaginea. Fiecare imagine se plătește în Gems, fără abonament.

  • 15modele de imagini
  • $0.009Cel mai mic preț implicit, per imagine
  • 20Generări simultane
  • $0Taxă lunară

Modele

Toate modelele de imagini din API-ul Mage

Prețurile sunt per generare, în Gems. 1.000 de Gems costă $1 în pachetul standard, iar pachetele mai mari adaugă Gems bonus. Prețul depinde de model, rezoluție și durată; se afișează prețul pentru setările implicite, iar fiecare răspuns indică suma exactă în billing.gems_charged. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.

ModelIdeal pentruValori model_idPreț implicit
AnimaCreat special pentru animeanima-v120 Gems ($0.02)
ChromaOpen-weights, construit pe Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Prompturi lungi și editări cu mai multe referințeflux2-dev40 Gems ($0.04)
GPT Image 2Prompturi precise și text lizibilgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine, în trei niveluri de calitategrok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.075 Gems ($0.075)
GuavaFotorealism care trece drept fotografieguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamRapid și versatil, cu prompturi negativehidream-fast20 Gems ($0.02)
Krea 2Estetică superbă în câteva secundekrea-2-turbo20 Gems ($0.02)
MangoFamilia noastră de imagini de topmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo135 Gems ($0.135)
Nano Banana 2Text clar, lizibil, până la 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL cu fețe și mâini corectate6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
Stable Diffusion v1.5Clasicul, la preț mic15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeStable Diffusion-ul care ascultă cel mai binesd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL optimizat pentru fotorealism6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageCel mai rapid model de imagini de pe Magez-image-turbo10 Gems ($0.01)

Pornire rapidă

Generează o imagine cu Anima v1

Setează MAGE_API_KEY, trimite cererea și interoghează până se termină. Înlocuiește anima din URL cu orice model de mai sus.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

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.

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ă.

Cazuri de utilizare

Ce construiesc dezvoltatorii cu API-ul de imagini

  • Imagini de produs și de marketing

    Generează la cerere fotografii de produs, variante de reclame și postări pentru social media, cu text lizibil de la GPT Image 2.5 sau Nano Banana 2.

  • Personaje consecvente

    Salvează un personaj o dată și păstrează aceeași față într-un set întreg cu Mango 3, Guava 2 Pro și alte modele care acceptă mențiuni @handle.

  • Fluxuri de editare a imaginilor

    Trimite o imagine sursă împreună cu o instrucțiune, ca să schimbi exact ce ceri și să lași restul neschimbat.

  • Aplicații și jocuri

    Generează avatare, stickere, cărți și scene direct în produsul tău, fără să găzduiești niciun GPU.

  • Portrete fotorealiste

    Guava 2 Pro redă portrete, fotografii de modă și de lifestyle cu piele, țesături și lumină demne de realitate.

  • Schițe rapide la scară mare

    Z-Image Turbo și Krea 2 țin prețurile mici pentru miniaturi în volum mare și primele versiuni.

Întrebări frecvente

Întrebări frecvente

Care este cel mai bun API de generare de imagini cu AI?
Depinde de sarcină. Pe Mage, Mango 3 este alegerea implicită pentru majoritatea imaginilor: urmează instrucțiuni precise, păstrează consecvența personajelor și editează fără să afecteze restul imaginii. Guava 2 Pro este cel mai bun pentru fotorealism, GPT Image 2.5 și Nano Banana 2 pentru text în imagini, iar Z-Image Turbo sau Krea 2 pentru schițe rapide și ieftine. Toate rulează prin același API.
API-ul de imagini acceptă editare de imagini și imagini de referință?
Da. Modelele care acceptă imagini le primesc în câmpurile image și additional_images, ca URL-uri, URL-uri de date sau încărcări. Pagina fiecărui model listează intrările acceptate și câte imagini de referință poate folosi.
Ce rezoluții acceptă API-ul de imagini?
Depinde de model: 1K și 2K la majoritatea modelelor, 3K la Mango 3S și până la 4K la Mango 2 și Nano Banana 2. Pagina fiecărui model listează opțiunile de rezoluție și de raport de aspect.
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 APICitește documentația API