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

Mage API · Model pro video

Magejutsu API

Přetvoř libovolné video a zachovej jeho pohyb

Získat API klíčVyzkoušej Magejutsu v playgroundu
POST https://api.mage.space/v1/magejutsu/generate

Stručně

Magejutsu API spouští Magejutsu a 2 další varianty přes Mage na POST https://api.mage.space/v1/magejutsu/generate. Požadavek ve výchozím nastavení stojí 1 856 Gems (asi 1,856 $) a nevyžaduje předplatné. Magejutsu přijímá uložené postavy a reference přes @handle v promptu.

  • VideoVýstup
  • 3Varianty
  • 1,856Gems za klip, výchozí
  • $1.856Přibližně v USD

Přehled

Co umí Magejutsu API

Přetvoří video, které už máš: pošli klip a fotky toho, kdo nebo co má nahradit původní postavu či předmět, a pohyb, kamera, načasování i zvuk zůstanou tak, jak byly natočeny. Zdrojová videa mohou mít 4 až 30 sekund.

Přetvoří existující video: režisér napíše z originálu prompt k úpravě a krok úpravy videa znovu vytvoří, kdo a co ve videu účinkuje. Pošli zdrojové video a náhradní reference; výstup si zachová délku, poměr stran, pohyb i zvuk originálu.

Jako vstup přijímá image, additional_images, videos.

Rychlý start

Volání Magejutsu API

Nastav MAGE_API_KEY, odešli požadavek na /magejutsu/generate a sleduj status_url, dokud se požadavek nedokončí.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
  "videos": [
    "https://example.com/input.jpg"
  ],
  "image": "https://example.com/input.jpg",
  "model_id": "magejutsu"
}' | 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('magejutsu', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  videos: [
    'https://example.com/input.jpg',
  ],
  image: 'https://example.com/input.jpg',
  model_id: 'magejutsu',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("magejutsu", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "videos": [
        "https://example.com/input.jpg",
    ],
    "image": "https://example.com/input.jpg",
    "model_id": "magejutsu",
})

print(request["result"]["url"])

Modely

Hodnoty model_id pro Magejutsu

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
magejutsuMagejutsuAno
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

Možnosti

Parametry Magejutsu

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

Vstupy

Mediální vstupy, které Magejutsu přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.
videosZdrojová videa.

Pravidla

Co Magejutsu API vynucuje

  • Zdrojové video trvá u magejutsu 4 až 30 sekund a u magejutsu-lite, rychlejší a levnější varianty, i u magejutsu-feather, nejlevnější a nejrychlejší, která umí jen motion_transfer a renderuje v 480p a 720p, 4 až 15 sekund. Výstup přebírá délku a poměr stran zdroje.
  • Každý požadavek v backendu zpracovává stejný director. Vyber motion_transfer, pokud chceš přestavět postavy a zachovat pohyb, nebo object_swap, pokud chceš změnit vybrané prvky a zbytek záběru nechat tak, jak byl natočen. Režim také určuje, jak se zdroj připraví: motion transfer řídí úpravu podle pohybu a obličeje každé nahrazené postavy, zatímco object swap upravuje zdroj tak, jak byl natočen. Klip, který vodítka nedokážou přečíst, například takový, ve kterém není žádná osoba, se vykreslí ze zdroje tak, jak byl natočen. Žádné ruční schvalování ani náhledová vykreslení nejsou potřeba.
  • Přes image a additional_images můžeš poslat až 30 referenčních obrázků. Režisér si přečte všechny a úprava dostane ty, které používá její prompt: až 27 u magejutsu, 9 u magejutsu-lite a 8 u magejutsu-feather.
  • Prompt je nepovinný: když ho nezadáš, director přiřadí reference ke zdroji podle výraznosti a vhodnosti.
  • Původní zvuk se ve výchozím nastavení obnoví. Pokud chceš zachovat vygenerovaný zvuk, nastav keep_original_audio na false.
  • Obrázky jsou náhrada; v promptu každý zmiň podle pořadí („obrázek 1 je osoba vlevo“).
  • V jednom požadavku se přijímá jen jedno zdrojové video; delší klip se odmítne, neořízne se.

Další video modely

Další API pro generování videa na Mage

  • Video · od 147 Gems

    Melon API

    Anime v pohybu, volitelně se zvukem

  • Video · od 30 Gems

    MiniMax-H3 API

    Rychlé open video se stereo zvukem

  • Video · od 173 Gems

    Plum API

    Zvuk ke každému klipu, až do 2K

  • Video · od 360 Gems

    Raspberry API

    Postavy oživené z prvního snímku

  • Video · od 40 Gems

    Wan Video v2.2 API

    Video s otevřenými váhami a variantou Lightning

  • Video · od 189 Gems

    Berry API

    Video věrné tvým referencím

Časté dotazy

Často kladené otázky

Kolik stojí Magejutsu API?
Požadavek na Magejutsu ve výchozím nastavení (Magejutsu) stojí 1 856 Gems, asi 1,856 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Generování, které se nepovede, se vrací; to zablokované pravidly obsahu Mage ne.
Jaký je endpoint Magejutsu API?
POST https://api.mage.space/v1/magejutsu/generate s hlavičkou Authorization: Bearer, která obsahuje tvůj klíč Mage API. Odpověď obsahuje status_url, na kterém si výsledek vyzvedneš.
Které modely Magejutsu můžu volat?
magejutsu (Magejutsu), magejutsu-lite (Magejutsu Lite), magejutsu-feather (Magejutsu Feather). Výchozí je Magejutsu.
Podporuje Magejutsu referenční obrázky nebo postavy?
Magejutsu přijímá image, additional_images, videos. Magejutsu přijímá uložené postavy a reference přes @handle v promptu.
Můžu používat Magejutsu z Claude nebo ChatGPT?
Ano. Připoj MCP server Mage ke Claude, ChatGPT, Claude Code, Grok nebo Cursoru a požádej o Magejutsu jménem. Tvůj asistent si přečte jeho možnosti pomocí get_model a před generováním uvede cenu.
Jak dlouho se výsledky Magejutsu uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

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íčVyzkoušej Magejutsu v playgroundu