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

Mage API · Videógenerálás

Az AI videógeneráló API szövegből vagy képekből

Szövegből videó, képből videó, első és utolsó képkockából videó, valamint referenciából videó 12 modellel, élen a Mage zászlóshajójával, a Cherry 2 Pro-val, sok klipben hanggal.

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

Dióhéjban

A Mage videógeneráló API egy REST API a https://api.mage.space/v1 címen, amely 12 szövegből és képből videót készítő modellt futtat, köztük a Cherry 2 Pro-t, a Lemont, a Plumot, a Melont, a MiniMax-H3-at, a Grok Videót és a Want. Küldj be egy promptot és opcionálisan képkockákat vagy referenciákat, kérdezd le a kérés állapotát, majd töltsd le az MP4-et. Minden klip modell, felbontás és hossz szerint Gemekkel fizetendő.

  • 12videómodell
  • $0.02Legolcsóbb alapbeállítás, klipenként
  • 20Egyidejű generálások
  • $0Havi díj

Modellek

A Mage API összes videómodellje

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
BerryVideó, amely hű marad a referenciáidhozberry, berry-2189 Gems ($0.189)
BlueberryRögzítsd az első és az utolsó képkockátblueberry, blueberry-v2360 Gems ($0.36)
CherryZászlóshajó videócsaládunkcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoA Grok Imagine mozgásbangrok-imagine-video375 Gems ($0.375)
KiwiHétköznapi videó, beállítás nélkülkiwi270 Gems ($0.27)
LemonMinden videófunkció, barátibb áronlemon245 Gems ($0.245)
LTX VideoGyors, nyílt súlyú videó az iterációhozltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonAnime mozgásban, opcionális hanggalmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Gyors nyílt videó sztereó hanggalminimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumHang minden klipen, akár 2K-igplum, plum-max338 Gems ($0.338)
RaspberryKarakterek életre keltése az első képkockábólraspberry360 Gems ($0.36)
Wan Video v2.2Nyílt súlyú videó Lightning változattalwan22-video, wan22-video-lightning40 Gems ($0.04)

Gyors kezdés

Videó generálása a Berry 2-vel

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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 videós API-val

  • Rövid és közösségi videók

    Készíts álló formátumú klipeket TikTokra, Reelsre és Shortsra promptból vagy termékképből.

  • Állóképek megmozgatása

    Változtass egy első képkockát, vagy egy első és utolsó képkockát mozgóképpé olyan képből videót készítő modellekkel, mint a Lemon és a Kiwi.

  • Karakterközpontú történetek

    Tartsd meg ugyanazt a karaktert a jelenetekben olyan referenciából videót készítő modellekkel, amelyek @handle karaktereket fogadnak.

  • Videó hanggal

    A Plum és más modellek a képpel együtt beszédet, hanghatásokat és környezeti zajokat generálnak, a hangokhoz pedig hangreferenciákat fogadnak.

  • Hirdetések és termékbemutatók

    Generálj egy reklámfilmből sok változatot, és válaszd ki a nyertest; az idempotens beküldések soha nem terhelnek kétszer.

  • Meglévő klipek szerkesztése

    A Berry, a Plum és a Grok Video a beküldött forrásvideót szerkeszti; a Lemon és a MiniMax-H3 referenciavideókat is fogad.

GYIK

Gyakran ismételt kérdések

Melyik a legjobb AI videógeneráló API?
A Mage-en a Cherry 2 Pro az alapértelmezett videómodell: támogatja a karaktereket, sok referenciaképet, hangreferenciákat, a 480p-től 1080p-ig terjedő kimenetet és akár 30 másodperces klipeket. Az első és utolsó képkocka feletti kontrollhoz a Lemon a választás, a generált hangos, akár 2K-s klipekhez a Plum, az olcsóbb piszkozatokhoz pedig a Cherry Mini vagy a Wan.
Támogatja a videós API a képből videó készítést?
Igen. A képből videót készítő modellek első képkockát fogadnak, néhány pedig utolsó képkockát vagy referenciaképeket is, URL-ként, data URL-ként vagy feltöltésként. Az egyes modellek oldalán megtalálod a bemeneteiket és azt, hogy kötelező-e a kép.
Milyen hosszúak lehetnek a generált videók?
Ez a modelltől és a felbontástól függ. Sok modell 4–15 másodpercet generál, a Cherry 2 Pro pedig eléri a 20, 25 és 30 másodpercet is. Az egyes modellek oldalán megtalálod a lehetséges hosszakat.
Mennyi ideig tart egy videó generálása?
Ez a modelltől, a felbontástól és a hossztól függ. Az API aszinkron: küldd be a kérést, majd kérdezd le a status_url-t fokozatosan növelt időközökkel, vagy hagyd, hogy az MCP-kliensed megvárja a get_request segítségével.
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ó