Přeskočit na obsah
PlaygroundDokumentaceZískat API klíč

Mage API · Generování videí

API pro generování videí pomocí AI z textu nebo obrázků

Text na video, obrázek na video, první a poslední snímek i reference na video z 12 modelů v čele s vlajkovým Cherry 2 Pro od Mage, u mnoha klipů se zvukem.

Získat API klíčČíst dokumentaci API
POST https://api.mage.space/v1/{model}/generate

Stručně

Mage API pro generování videí je REST API na https://api.mage.space/v1, které provozuje 12 modelů pro převod textu a obrázků na video, včetně Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video a Wan. Odešli prompt a volitelně snímky nebo reference, sleduj stav požadavku a stáhni si MP4. Každý klip se platí v Gems podle modelu, rozlišení a délky.

  • 12video modelů
  • $0.02Nejlevnější výchozí varianta, za klip
  • 20Souběžné generace
  • $0Měsíční poplatek

Modely

Všechny video modely v Mage API

Ceny jsou za jedno generování, v Gems. 1 000 Gems stojí 1 $ u standardního balíčku a větší balíčky přidávají bonusové Gems. Cena závisí na modelu, rozlišení a délce; zobrazená je cena s výchozím nastavením a každá odpověď uvádí přesnou částku v billing.gems_charged. Selhané generování se vrací; generování zablokované zásadami obsahu Mage ne.

ModelNejlepší proHodnoty model_idVýchozí cena
BerryVideo věrné tvým referencímberry, berry-2189 Gems ($0.189)
BlueberryZafixuj první a poslední snímekblueberry, blueberry-v2360 Gems ($0.36)
CherryNaše vlajková rodina video modelůcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine v pohybugrok-imagine-video375 Gems ($0.375)
KiwiVideo na každý den, bez nastavováníkiwi270 Gems ($0.27)
LemonVšechny video funkce za příznivější cenulemon245 Gems ($0.245)
LTX VideoRychlé video s otevřenými váhami pro iteraceltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonAnime v pohybu s volitelným zvukemmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Rychlé otevřené video se stereo zvukemminimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumZvuk v každém klipu, až do 2Kplum, plum-max338 Gems ($0.338)
RaspberryPostavy ožívají z prvního snímkuraspberry360 Gems ($0.36)
Wan Video v2.2Video s otevřenými váhami a variantou Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Rychlý start

Vygeneruj video pomocí Berry 2

Nastav MAGE_API_KEY, odešli požadavek a sleduj stav, dokud se nedokončí. Slovo berry v URL nahraď libovolným modelem výše.

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

Jak to funguje

Od API klíče k hotovému médiu na tři volání

Všechny modely sdílejí jedno ověřování, jeden asynchronní životní cyklus požadavku a stejné názvy polí.

  1. Vytvoř API klíč

    Přihlas se do Mage, otevři API → API Keys a vytvoř klíč. Začíná na mage_sk_ a zobrazí se jen jednou. Účet může mít 10 aktivních klíčů.

  2. Odešli generování

    Pošli POST s tělem JSON na https://api.mage.space/v1/{model}/generate s hlavičkou Authorization: Bearer. Odpověď přijde okamžitě a obsahuje request_id, status a status_url. Přidej hlavičku Idempotency-Key, aby tě opakování nikdy nestálo platbu navíc.

  3. Zjisti stav a stáhni výsledek

    Dotazuj se na status_url, dokud stav není completed, failed nebo cancelled. Dokončený požadavek obsahuje result.url se souborem obrázku, videa nebo audia, který se uchovává 30 dní.

Stavěné pro ostrý provoz

Co dostane každý požadavek na Mage API

  • Jeden klíč, všechny modely

    28 modelů pro obrázky, video a zvuk za jedním REST API a jedním zůstatkem Gems. Model přepneš změnou cesty v URL.

  • Platíš za každou generaci

    Žádné předplatné ani minimální útrata. Koupíš si Gems a každý požadavek se účtuje podle uvedené ceny. Neúspěšná generace se vrací, pokud ji neblokovaly zásady obsahu Mage.

  • Bezpečné opakování

    Idempotenční klíče zajistí, že opakované odeslání vrátí původní požadavek a nic se neúčtuje podruhé.

  • Konzistentní postavy

    Postavu nebo referenci ulož jednou a pak napiš @handle do libovolného promptu. Použiješ ji s každým modelem, který to podporuje.

  • Velké vstupy

    Obrázky, videa a zvuk můžeš posílat jako URL nebo data URL, případně nahrát soubory do 100 MB přes podepsaný upload.

  • 20 generací najednou

    Každý účet může spustit 20 generací současně a limit lze zvýšit podle tvého případu užití. Odmítnuté požadavky se nikdy neúčtují.

Případy použití

Co vývojáři tvoří pomocí video API

  • Krátká videa a sociální sítě

    Vytvářej vertikální klipy pro TikTok, Reels a Shorts z promptu nebo z obrázku produktu.

  • Animace statických obrázků

    Rozpohybuj první snímek, nebo první a poslední snímek, pomocí modelů obrázek na video, jako jsou Lemon a Kiwi.

  • Příběhy řízené postavami

    Zachovej stejnou postavu napříč záběry pomocí modelů reference na video, které přijímají postavy přes @handle.

  • Video se zvukem

    Plum a další modely generují spolu s obrazem řeč, zvukové efekty i atmosféru a pro hlasy přijímají zvukové reference.

  • Reklamy a ukázky produktů

    Vygeneruj mnoho variant spotu a vyber tu nejlepší. Idempotentní odesílání zaručuje, že nikdy nezaplatíš dvakrát.

  • Úpravy existujících klipů

    Berry, Plum a Grok Video upravují zdrojové video, které odešleš. Lemon a MiniMax-H3 přijímají i referenční videa.

Časté dotazy

Často kladené otázky

Které je nejlepší API pro generování videí pomocí AI?
V Mage je výchozí volbou pro video Cherry 2 Pro: podporuje postavy, mnoho referenčních obrázků, zvukové reference, výstup od 480p do 1080p a klipy dlouhé až 30 sekund. Lemon je volba pro řízení prvním a posledním snímkem, Plum pro klipy s generovaným zvukem až do 2K a Cherry Mini nebo Wan pro levnější návrhy.
Podporuje video API převod obrázku na video?
Ano. Modely obrázek na video přijímají první snímek a některé také poslední snímek nebo referenční obrázky, a to jako URL, data URL nebo nahrané soubory. Stránka každého modelu uvádí jeho vstupy a zda je obrázek povinný.
Jak dlouhá mohou generovaná videa být?
Záleží na modelu a rozlišení. Mnoho modelů generuje 4 až 15 sekund a Cherry 2 Pro dosahuje 20, 25 i 30 sekund. Stránka každého modelu uvádí dostupné délky.
Jak dlouho trvá generování videa?
Záleží na modelu, rozlišení a délce. API je asynchronní: odešli požadavek a poté opakovaně dotazuj status_url s postupně se prodlužujícími intervaly, nebo nech svého MCP klienta čekat pomocí get_request.
Kolik stojí Mage API?
Žádné předplatné ani měsíční poplatek. Každá generace se platí v Gems podle uvedené ceny modelu a 1 000 Gems stojí 1 $ ve standardním balíčku. Stránka každého modelu uvádí cenu při výchozím nastavení a každá odpověď obsahuje přesnou účtovanou částku. Neúspěšná generace se vrací; ta, kterou zablokují zásady obsahu Mage, ne. Požadavek, na který zůstatek nestačí, se odmítne dřív, než se cokoli naúčtuje.
Potřebuji k používání API členství v Mage?
Ne. API funguje jen na Gems. Členské plány a jejich neomezené generování v aplikaci se na požadavky API nevztahují, takže ho může volat jakýkoli účet Mage s Gems.
Můžu výstupy z API používat komerčně?
Ano. Obsah, který v Mage vytvoříš, včetně toho z API a MCP serveru, můžeš používat komerčně. Uvedení autora oceníme, ale není povinné.
Jaké jsou limity požadavků?
Účet může mít najednou 20 generací ve frontě nebo ve zpracování. Odeslání nad tento limit je odmítnuto s chybou 429 a nic nestojí. Pokud chceš limit pro svůj případ navýšit, napiš na [email protected].
Může můj AI agent používat Mage API?
Ano. Agenti mohou volat REST API pomocí klíče nebo se připojit k Mage MCP serveru, který Claude, ChatGPT, Claude Code, Grok a Cursor nabízí šestnáct hotových nástrojů pro výběr modelu, zjištění ceny, generování a stažení výsledku. Podívej se na MCP server.
Existuje SDK pro Mage API?
Ano. Oficiální balíček @mage-space/sdk na npm a mage-space na PyPI jsou open source a mají typy pro každý model. Odešlou požadavek, počkají na výsledek, bezpečně zopakují pokusy a nahrají za tebe soubory. Uživatelé ComfyUI si mohou nainstalovat balík nodů comfyui-mage. Podívej se na Mage SDK.
Už používám jiné API pro generování. Co musím změnit?
Nasměruj klienta na https://api.mage.space/v1, posílej svůj klíč Mage jako Bearer token a namapuj svá pole podle stránky modelu: prompt, aspect_ratio, resolution, duration a model_id fungují stejně u všech modelů Mage. Požadavky jsou asynchronní, takže je odešli a pak opakovaně dotazuj status_url.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.

Získat API klíčČíst dokumentaci API