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

Mage API · A következő ötletedhez építve

Egy API. Végtelen lehetőség.

Hozd el a Mage legjavát a termékedbe és az AI-asszisztensedbe. Generálj képeket, videókat és hangot egyetlen API-kulccsal vagy egyetlen MCP-kapcsolattal.

API-kulcs kéréseAsszisztens csatlakoztatásaAPI-dokumentáció
https://api.mage.space/v1

Dióhéjban

A Mage a fejlesztőknek egy REST API-t kínál a https://api.mage.space/v1 címen, valamint egy távoli MCP-szervert a https://mcp.mage.space/mcp címen. Mindkettő ugyanazt a 28 kép-, videó- és hangmodellt futtatja, köztük a csak a Mage-en elérhető Mango 3 és Cherry 2 Pro modellt, egyetlen fiókkal, és minden generálás Gemekkel fizetendő, előfizetés nélkül.

  • 28Modellek
  • 3Médiatípusok
  • 16MCP-eszközök
  • $0Havi díj

Hogyan kezdj hozzá

Használd kódból, az asszisztensedből vagy a ComfyUI-ból

  • REST API

    A Mage API

    Indíts generálásokat a saját kódodból egy kulccsal. Aszinkron kérések, idempotens újrapróbálkozások, akár 100 MB-os feltöltések és 20 egyidejű generálás.

  • SDK-k

    TypeScript és Python SDK-k

    Hivatalos, típusos kliensek, amelyek pár sorban elküldik a kérést, megvárják az eredményt, biztonságosan újrapróbálkoznak és fájlokat töltenek fel.

  • MCP-szerver

    A Mage MCP-szerver

    Csatlakoztasd a Claude-ot, a ChatGPT-t, a Claude Code-ot, a Groköt vagy a Cursort bejelentkezéssel, és kérj képeket, videókat és hangot egyszerű szavakkal.

  • ComfyUI

    Mage a ComfyUI-hoz

    A Mango, a Cherry, a Seed Audio és az összes többi Mage-modell ComfyUI-node-ként. Nincs szükség GPU-ra, és modelleket sem kell letöltened.

Médiatípus szerint

Generáló API-k

Gyors kezdés

Az első generálásod

Hozz létre egy kulcsot az API → API-kulcsok menüben, exportáld MAGE_API_KEY néven, és futtasd az alábbiak egyikét.

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

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.

MCP

Mage az AI-asszisztensedben

  • Mage a Claude-ban

    Generálj képeket, videókat és hangot a Claude-ban weben, az asztali alkalmazásban, a mobilappokban és a Coworkben.

  • Mage a ChatGPT-ben

    Generálj képeket, videókat és hangot a ChatGPT-ben személyes MCP-alkalmazásként.

  • Mage a Claude Code-ban

    Generálj képeket, videókat és hangokat a Claude Code-ban, a terminálodban és a szerkesztődben.

  • Mage a Grokban

    Generálj képeket, videókat és hangokat a Grokban egyéni csatlakozóként.

  • Mage a Cursorban

    Generálj képeket, videókat és hangokat a Cursor Agent módjában.

Modellek

Kiemelt modellek

  • Kép · 40 Gemtől

    Flux 2 API

    Hosszú promptok és több referenciás szerkesztések

  • Kép · 9 Gemtől

    GPT Image 2 API

    Pontos promptok és olvasható szöveg

  • Kép · 37 Gemtől

    Guava API

    Fotórealizmus, ami fényképnek is elmegy

  • Kép · 135 Gemtől

    Mango API

    Zászlóshajó képmodellcsaládunk

  • Kép · 51 Gemtől

    Nano Banana 2 API

    Éles, jól olvasható szöveg, akár 4K-ban

  • Videó · 618 Gemtől

    Cherry API

    Zászlóshajó videómodellcsaládunk

  • Videó · 245 Gemtől

    Lemon API

    Minden videófunkció, barátibb áron

  • Videó · 338 Gemtől

    Plum API

    Hang minden klipen, akár 2K-ig

  • Hang · 19 Gemtől

    Seed Audio API

    Hangok, zene és hangeffektek egyetlen promptból

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

GYIK

Gyakran ismételt kérdések

Mi a Mage API?
A Mage API egy REST API a https://api.mage.space/v1 címen, amellyel a saját kódodból generálhatsz képeket, videókat és hangokat 28 modellel. A kérések aszinkron módon futnak, és generálásonként fizetsz értük Gemekkel.
Mi a Mage MCP-szerver?
Egy távoli Model Context Protocol szerver a https://mcp.mage.space/mcp címen, amellyel az AI-asszisztensek képeket, videókat és hangokat generálhatnak a Mage-fiókodban. Az asszisztens 16 eszközt kap: modellt választhat, árat kérhet, generálhat, megvárhatja az eredményt, és használhatja a mentett karaktereidet, referenciáidat és az előzményeidet.
Kell API-kulcs az MCP-szerver használatához?
Nem. A Claude, a ChatGPT, a Grok, a Cursor és a Claude Code úgy csatlakozik, hogy OAuth-on keresztül bejelentkezel a Mage-be. Az API-kulcs opcionális, fej nélküli környezetekhez, például CI-hoz.
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éseAsszisztens csatlakoztatása