Mage API · Videómodell
Magejutsu API
Cserélj szereplőt bármely videóban, a mozgás megmarad
POST https://api.mage.space/v1/magejutsu/generateDióhéjban
A Magejutsu API a Magejutsu modellt és még 2 változatot futtat a Mage-en keresztül a POST https://api.mage.space/v1/magejutsu/generate végponton. Egy alapbeállításokkal küldött kérés 1 856 Gembe kerül (kb. 1,856 $), előfizetés nélkül. A Magejutsu elfogadja a mentett karaktereket, és a promptban @handle alapján hivatkozhatsz referenciákra.
- VideóKimenet
- 3Variánsok
- 1,856Gems klipenként, alapértelmezett
- $1.856Körülbelül, USD-ben
Áttekintés
Mit tud a Magejutsu API
Egy már meglévő videót ír át: küldd el a klipet és fotókat arról, ki vagy mi kerüljön a helyére, a mozgás, a kamera, az időzítés és a hang pedig marad, ahogy felvették. A forrás 4–30 másodperces lehet.
Egy meglévő videót szereposztja újra: egy rendező a forrás alapján megírja a szerkesztési promptot, a videószerkesztő lépés pedig újraépíti, ki és mi szerepel benne. Küldd el a forrásvideót és a csereképeket; a kimenet megtartja a forrás hosszát, képarányát, mozgását és hangját.
Bemenetként az image, additional_images, videos mezőket fogadja.
Gyors kezdés
A Magejutsu API hívása
Állítsd be a MAGE_API_KEY-t, küldd be a kérést a /magejutsu/generate végpontra, és kérdezd le a status_url címet, amíg a kérés be nem fejeződik.
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"])Modellek
A Magejutsu model_id értékei
Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.
| model_id | Név | Alapértelmezett |
|---|---|---|
| magejutsu | Magejutsu | Igen |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Beállítások
A Magejutsu paraméterei
Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.
| Mező | Értékek |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Bemenetek
A Magejutsu által elfogadott médiabemenetek
Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.
| Mező | Szerep |
|---|---|
| image | A referenciakép. |
| additional_images | További referenciaképek. |
| videos | A forrásvideók. |
Szabályok
Amit a Magejutsu API kikényszerít
- A forrásvideó hossza 4–30 másodperc lehet a magejutsu modellnél, és 4–15 másodperc a magejutsu-lite modellnél, amely a gyorsabb és olcsóbb változat, valamint a magejutsu-feather modellnél, amely a legolcsóbb és leggyorsabb, csak motion_transfer módban működik, és 480p és 720p felbontásban renderel. A kimenet a forrás hosszát és képarányát követi.
- Minden kérés ugyanazt a rendezőt futtatja a háttérben. Válaszd a motion_transfer módot, ha újra akarod építeni a szereplőket, de meg akarod tartani a mozgást, vagy az object_swap módot, ha kiválasztott elemeket szeretnél lecserélni, a felvétel többi részét pedig úgy hagynád, ahogy forgatták. A mód azt is meghatározza, hogyan készül elő a forrás: a motion transfer a szerkesztést a lecserélt szereplők mozgásával és arcával vezérli, az object swap pedig a forrást úgy szerkeszti, ahogy forgatták. Ha a vezérlés nem tud értelmezni egy klipet, például mert nincs benne ember, akkor az a forrásból, úgy renderelődik, ahogy forgatták. Nincsenek kézi jóváhagyási lépések, és vázlatrenderek sem készülnek.
- Legfeljebb 30 referenciaképet küldhetsz az image és az additional_images mezőben. A rendező mindegyiket elolvassa, a szerkesztés pedig azokat kapja meg, amelyeket a prompt használ: magejutsu esetén legfeljebb 27-et, magejutsu-lite esetén 9-et, magejutsu-feather esetén 8-at.
- A prompt megadása nem kötelező: ha nincs, a rendező a referenciákat feltűnőség és illeszkedés alapján rendeli hozzá a forráshoz.
- Az eredeti hang alapértelmezés szerint visszaállításra kerül; állítsd a keep_original_audio értékét false-ra, ha a generált hangot szeretnéd megtartani.
- A képek a cserék; a promptban említsd meg mindegyiket a helye szerint („az 1. kép a bal oldali személy”).
- Kérésenként csak egy forrásvideót fogad el; a hosszabb klipet elutasítja ahelyett, hogy levágná.
További videómodellek
További videógeneráló API-k a Mage-en
Melon API
Anime mozgásban, opcionális hanggal
MiniMax-H3 API
Gyors, nyílt videómodell sztereó hanggal
Plum API
Hang minden klipen, akár 2K-ig
Raspberry API
Karakterek életre keltése egy első képkockából
Wan Video v2.2 API
Nyílt súlyozású videómodell Lightning változattal
Berry API
Videó, amely hű marad a referenciáidhoz
GYIK
Gyakran ismételt kérdések
Mennyibe kerül a Magejutsu API?
Mi a Magejutsu API végpontja?
Mely Magejutsu modelleket hívhatom meg?
Támogatja a Magejutsu a referenciaképeket vagy a karaktereket?
Használhatom a Magejutsut Claude-ból vagy ChatGPT-ből?
Meddig őrzik meg a Magejutsu eredményeit?
Kezdj el építeni a Mage-dzsel
Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.