API Mage · Model video
Magejutsu API
Refă distribuția oricărui video, păstrându-i mișcarea
POST https://api.mage.space/v1/magejutsu/generatePe scurt
API-ul Magejutsu rulează Magejutsu și alte 2 variante prin Mage la POST https://api.mage.space/v1/magejutsu/generate. O cerere cu setările implicite costă 1.856 Gems (aprox. 1,856 $), fără abonament. Magejutsu acceptă personaje salvate și referințe prin @handle în prompt.
- VideoRezultat
- 3Variante
- 1,856Gems per clip, implicit
- $1.856Aproximativ, în USD
Prezentare generală
Ce face Magejutsu API
Refă distribuția unui video pe care îl ai deja: trimiți clipul și fotografii cu cine sau ce îl înlocuiește, iar mișcarea, camera, ritmul și sunetul rămân ca la filmare. Sursele pot avea între 4 și 30 de secunde.
Refă distribuția unui video existent: un regizor scrie promptul de editare pornind de la sursă, iar o trecere de editare video reconstruiește cine și ce apare în el. Trimiți videoul sursă și referințele de înlocuire; rezultatul păstrează durata, formatul, mișcarea și sunetul sursei.
Acceptă image, additional_images, videos ca intrări.
Pornire rapidă
Apelează Magejutsu API
Setează MAGE_API_KEY, trimite cererea la /magejutsu/generate și interoghează status_url până se finalizează cererea.
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"])Modele
Valorile model_id pentru Magejutsu
Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.
| model_id | Nume | Implicit |
|---|---|---|
| magejutsu | Magejutsu | Da |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Opțiuni
Parametrii Magejutsu
Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.
| Câmp | Valori |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Intrări
Fișierele media acceptate de Magejutsu
Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.
| Câmp | Rol |
|---|---|
| image | Imaginea de referință. |
| additional_images | Imagini de referință suplimentare. |
| videos | Videoclipurile sursă. |
Reguli
Ce impune Magejutsu API
- Videoclipul sursă poate dura între 4 și 30 de secunde pe magejutsu și între 4 și 15 pe magejutsu-lite, varianta mai rapidă și mai ieftină, dar și pe magejutsu-feather, cea mai ieftină și mai rapidă, care rulează doar motion_transfer și generează în 480p și 720p. Rezultatul păstrează durata și raportul de aspect ale sursei.
- Fiecare cerere folosește același director în backend. Alege motion_transfer pentru a reconstrui interpreții și a păstra mișcarea sau object_swap pentru a schimba elementele selectate și a păstra restul cadrului așa cum a fost filmat. Modul decide și cum este pregătită sursa: un motion transfer ghidează editarea cu mișcarea și fața fiecărui interpret înlocuit, iar un object swap editează sursa așa cum a fost filmată. Un clip pe care ghidarea nu îl poate citi, de exemplu unul fără nicio persoană, este randat din sursa așa cum a fost filmată. Nu există pași de aprobare manuală și nici randări de probă.
- Trimite până la 30 de imagini de referință prin image și additional_images. Regizorul le citește pe toate, iar editarea primește imaginile folosite în prompt: până la 27 pe magejutsu, 9 pe magejutsu-lite și 8 pe magejutsu-feather.
- Promptul este opțional: fără el, directorul asociază referințele cu sursa în funcție de importanță și potrivire.
- Audio original este restaurat implicit; setează keep_original_audio la false pentru a păstra audio generat.
- Imaginile sunt înlocuitorii; menționează-le în prompt după poziție („imaginea 1 este persoana din stânga”).
- Videoul sursă este singurul acceptat într-o cerere; un clip mai lung este refuzat, nu tăiat.
Mai multe modele video
Alte API-uri de generare video pe Mage
Melon API
Anime în mișcare, cu sunet opțional
MiniMax-H3 API
Video open rapid cu sunet stereo
API Plum
Sunet pe fiecare clip, până la 2K
API Raspberry
Personaje aduse la viață dintr-un prim cadru
Wan Video v2.2 API
Video open-weights cu variantă Lightning
Berry API
Video fidel referințelor tale
Întrebări frecvente
Întrebări frecvente
Cât costă Magejutsu API?
Care este endpointul Magejutsu API?
Ce modele Magejutsu pot apela?
Magejutsu acceptă imagini de referință sau personaje?
Pot folosi Magejutsu din Claude sau ChatGPT?
Cât timp sunt păstrate rezultatele Magejutsu?
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.