Ugrás a tartalomhoz
PlaygroundDokumentációAPI-kulcs igénylése

Mage API · Képgenerálás

Az AI képgeneráló API minden modellhez

Szövegből képgenerálás, képszerkesztés és következetes karakterek 15 modellel, köztük a Mage zászlóshajójával, a Mango 3-mal – egyetlen kulccsal és egyetlen egyenleggel.

API-kulcs kéréseAPI-dokumentáció
POST https://api.mage.space/v1/{model}/generate

Dióhéjban

A Mage képgeneráló API egy REST API a https://api.mage.space/v1 címen, amely 15 szövegből képet készítő és képszerkesztő modellt futtat, köztük a Mango 3, a Guava 2 Pro, a GPT Image 2.5, a Nano Banana 2, a Flux 2 és a Krea 2 modelleket. A promptot POST-tal küldöd a /{model}/generate végpontra, lekérdezed a kérést, majd letöltöd a képet. Minden képért Gemekben fizetsz, előfizetés nélkül.

  • 15képmodell
  • $0.009Legolcsóbb alapár, képenként
  • 20Egyidejű generálások
  • $0Havi díj

Modellek

Minden képmodell a Mage API-ban

Az árak generálásonként értendők, Gemekben. 1000 Gem 1 dollárba kerül a standard csomagban, a nagyobb csomagok bónusz Gemeket adnak. Az ár a modelltől, a felbontástól és a hossztól függ; itt az alapbeállítások szerinti ár látható, a pontos terhelést pedig minden válasz a billing.gems_charged mezőben közli. A sikertelen generálás árát visszatérítjük; azét, amelyet a Mage tartalmi irányelvei blokkolnak, nem.

ModellErre a legjobbmodel_id értékekAlapár
AnimaKifejezetten animéhez készültanima-v120 Gems ($0.02)
ChromaNyílt súlyozású, Flux alapokonchroma-v1-hd35 Gems ($0.035)
Flux 2Hosszú promptokhoz és több referenciás szerkesztéshezflux2-dev40 Gems ($0.04)
GPT Image 2Pontos promptok és olvasható szöveggpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine, három minőségi szintengrok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.075 Gems ($0.075)
GuavaFotórealizmus, ami fényképnek is elmenneguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamGyors és sokoldalú, negatív promptokkalhidream-fast20 Gems ($0.02)
Krea 2Gyönyörű esztétika másodpercek alattkrea-2-turbo20 Gems ($0.02)
MangoZászlóshajó képmodell-családunkmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo135 Gems ($0.135)
Nano Banana 2Éles, olvasható szöveg, akár 4K-bannano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL javított arcokkal és kezekkel6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
Stable Diffusion v1.5A klasszikus, kis költségvetéssel15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeA legjobban hallgató Stable Diffusionsd-3-5-large10 Gems ($0.01)
Stable Diffusion XLFotórealisztikusra hangolt SDXL6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageA leggyorsabb képmodell a Mage-enz-image-turbo10 Gems ($0.01)

Gyors kezdés

Képgenerálás az Anima v1-gyel

Állítsd be a MAGE_API_KEY-t, küldd be a kérést, és kérdezd le, amíg el nem készül. Az URL-ben az anima helyére bármelyik fenti modellt beírhatod.

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"])

Hogyan működik

Az API-kulcstól a kész médiáig három hívással

Minden modell ugyanazt a hitelesítést, ugyanazt az aszinkron kérési életciklust és ugyanazokat a mezőneveket használja.

  1. API-kulcs létrehozása

    Jelentkezz be a Mage-be, nyisd meg az API → API-kulcsok oldalt, és hozz létre egy kulcsot. A kulcs mage_sk_ előtaggal kezdődik, és csak egyszer jelenik meg. Egy fiókhoz 10 aktív kulcs tartozhat.

  2. Generálás indítása

    Küldj egy JSON törzsű POST kérést a https://api.mage.space/v1/{model}/generate címre Authorization: Bearer fejléccel. A válasz azonnal megérkezik request_id-val, status-szal és status_url-lel. Add meg az Idempotency-Key fejlécet, hogy egy újrapróbálkozás ne kerüljön kétszer pénzbe.

  3. Lekérdezés és letöltés

    Kérdezd le a status_url címet, amíg a státusz completed, failed vagy cancelled nem lesz. A befejezett kérés result.url mezője a kép-, videó- vagy hangfájlra mutat, amelyet 30 napig tárolunk.

Éles használatra készült

Mit kap minden Mage API-kérés

  • Egy kulcs, minden modell

    28 kép-, videó- és hangmodell egyetlen REST API és egyetlen Gem-egyenleg mögött. A modellt az URL-útvonal módosításával válthatod.

  • Generálásonként fizetsz

    Nincs előfizetés és minimális költés. Gemeket vásárolsz, és minden kérés a feltüntetett árat terheli. A sikertelen generálás árát visszatérítjük, kivéve, ha a Mage tartalmi irányelvei letiltották.

  • Biztonságos újrapróbálás

    Az idempotencia-kulcsok miatt az újrapróbált beküldés az eredeti kérést adja vissza, újabb terhelés nélkül.

  • Egységes karakterek

    Mentsd el egyszer a karaktert vagy a referenciát, majd írd be a @handle-t bármelyik promptba, és használhatod minden olyan modellel, amely támogatja.

  • Nagy bemenetek

    Küldj kép-, videó- és hangbemeneteket URL-ként vagy data URL-ként, vagy tölts fel akár 100 MB-os fájlokat aláírt feltöltéssel.

  • 20 egyidejű generálás

    Minden fiók egyszerre 20 generálást futtathat, és a korlát az igényeidhez igazítva emelhető. Az elutasított kéréseket sosem terheljük.

Felhasználási esetek

Mit építenek a fejlesztők a kép API-val

  • Termék- és marketingképek

    Készíts igény szerint termékfotókat, hirdetésváltozatokat és közösségi posztokat, olvasható szöveggel a GPT Image 2.5-tel vagy a Nano Banana 2-vel.

  • Egységes karakterek

    Mentsd el egyszer a karaktert, és tartsd meg ugyanazt az arcot egy egész sorozaton át a Mango 3-mal, a Guava 2 Pro-val és más modellekkel, amelyek értik a @handle említéseket.

  • Képszerkesztési munkafolyamatok

    Küldj egy forrásképet egy utasítással, és pontosan azt módosítja, amit kérsz, a többit pedig érintetlenül hagyja.

  • Appok és játékok

    Generálj avatarokat, matricákat, kártyákat és jeleneteket közvetlenül a termékedben, egyetlen GPU üzemeltetése nélkül.

  • Fotórealisztikus portrék

    A Guava 2 Pro életszerű bőrrel, anyagokkal és fényekkel rendereli a portrékat, divatfotókat és életstílus-képeket.

  • Gyors piszkozatok nagy tételben

    A Z-Image Turbo és a Krea 2 alacsonyan tartja az árakat a nagy mennyiségű miniatűrnél és az első körös változatoknál.

GYIK

Gyakran ismételt kérdések

Melyik a legjobb AI képgeneráló API?
Ez a feladattól függ. A Mage-en a Mango 3 az alapértelmezett a legtöbb képhez: pontosan követi az utasításokat, következetesen tartja a karaktereket, és a kép többi részének megzavarása nélkül szerkeszt. A Guava 2 Pro a fotórealizmusban a legjobb, a GPT Image 2.5 és a Nano Banana 2 a képeken lévő szövegben, a Z-Image Turbo vagy a Krea 2 pedig a gyors, olcsó piszkozatokban. Mindegyik ugyanazon az API-n keresztül fut.
Támogatja a képes API a képszerkesztést és a referenciaképeket?
Igen. A képeket fogadó modellek az image és additional_images mezőben várják őket URL-ként, data URL-ként vagy feltöltésként. Az egyes modellek oldalán megtalálod a bemeneteiket és azt, hogy hány referenciaképet fogadnak.
Milyen felbontásokat támogat a képes API?
Modellfüggő: a legtöbb modellnél 1K és 2K, a Mango 3S-nél 3K, a Mango 2-nél és a Nano Banana 2-nél pedig akár 4K. Az egyes modellek oldalán megtalálod a felbontási és képarány-lehetőségeket.
Mennyibe kerül a Mage API?
Nincs előfizetés vagy havidíj. Minden generálást Gemekkel fizetsz a modell feltüntetett árán, és a standard csomagban 1000 Gem 1 dollárba kerül. Minden modelloldalon az alapbeállításokhoz tartozó ár látható, és minden válasz megadja a pontos terhelést. A sikertelen generálás árát visszatérítjük; azt viszont nem, amelyet a Mage tartalmi irányelvei blokkoltak. Az a kérés, amelyet az egyenleged nem fedez, elutasításra kerül, mielőtt bármit terhelnénk.
Kell Mage-tagság az API használatához?
Nem. Az API kizárólag Gemekkel működik. A tagsági csomagok és a hozzájuk tartozó korlátlan alkalmazáson belüli generálás nem vonatkozik az API-kérésekre, így bármelyik Mage-fiók használhatja, amelyen van Gem.
Felhasználhatom kereskedelmi célra az API kimeneteit?
Igen. A Mage-dzsel készített tartalmakat – az API-n és az MCP-szerveren keresztül létrehozottakat is – kereskedelmi célra is felhasználhatod. A forrásmegjelölést köszönjük, de nem kötelező.
Mik a sebességkorlátok?
Egy fiókon egyszerre 20 generálás lehet sorban vagy futás alatt. Az ennél több beküldést 429-es hibával elutasítjuk, és nem kerül semmibe. Ha a felhasználási esetedhez emelni kell a korlátot, írj a [email protected] címre.
Használhatja az AI-ügynököm a Mage API-t?
Igen. Az ügynökök kulccsal hívhatják a REST API-t, vagy csatlakozhatnak a Mage MCP-szerveréhez, amely a Claude, a ChatGPT, a Claude Code, a Grok és a Cursor számára tizenhat kész eszközt ad a modellválasztáshoz, az árajánlathoz, a generáláshoz és az eredmény lekéréséhez. Részletek: az MCP-szerver.
Van SDK a Mage API-hoz?
Igen. Az npm-en elérhető hivatalos @mage-space/sdk csomag és a PyPI-on elérhető mage-space nyílt forráskódú, és minden modellhez típusos. Beküldik a kérést, megvárják az eredményt, biztonságosan újrapróbálkoznak, és feltöltik helyetted a fájlokat. A ComfyUI-felhasználók telepíthetik a comfyui-mage node-csomagot. Részletek: a Mage SDK-k.
Már használok másik generálási API-t. Mit kell módosítanom?
Irányítsd a klienst a https://api.mage.space/v1 címre, küldd a Mage-kulcsodat Bearer tokenként, és feleltesd meg a mezőidet a modelloldalnak: a prompt, az aspect_ratio, a resolution, a duration és a model_id minden Mage-modellnél ugyanúgy működik. A kérések aszinkronok, ezért küldd be őket, majd kérdezd le rendszeresen a status_url címet.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.

API-kulcs kéréseAPI-dokumentáció