Mage API · Videomodel
Magejutsu API
Geef elke video een nieuwe cast, met behoud van de beweging
POST https://api.mage.space/v1/magejutsu/generateIn één oogopslag
De Magejutsu API draait Magejutsu en 2 andere varianten via Mage op POST https://api.mage.space/v1/magejutsu/generate. Een verzoek met de standaardinstellingen kost 1.856 Gems (ongeveer $1,856), zonder abonnement. Magejutsu werkt met opgeslagen personages en met referenties via @handle in de prompt.
- VideoUitvoer
- 3Varianten
- 1,856Gems per clip (standaard)
- $1.856Ongeveer, in USD
Overzicht
Wat de Magejutsu API doet
Geeft een video die je al hebt een nieuwe cast: stuur de clip en foto's van wie of wat er in beeld komt, en de beweging, camera, timing en het geluid blijven zoals gefilmd. Bronvideo's duren 4 tot 30 seconden.
Geeft een bestaande video een nieuwe cast: een regisseur schrijft de bewerkingsprompt op basis van de bron en een videobewerkingsronde bouwt opnieuw op wie of wat er speelt. Stuur de bronvideo en de vervangende referenties mee; de uitvoer behoudt de lengte, verhouding, beweging en het geluid van de bron.
Het accepteert image, additional_images en videos als invoer.
Snel starten
De Magejutsu API aanroepen
Stel MAGE_API_KEY in, verstuur naar /magejutsu/generate en poll status_url tot het verzoek is voltooid.
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"])Modellen
Magejutsu model_id-waarden
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| magejutsu | Magejutsu | Ja |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Opties
Magejutsu-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Invoer
Media-invoer die Magejutsu accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| image | De referentieafbeelding. |
| additional_images | Extra referentieafbeeldingen. |
| videos | De bronvideo's. |
Regels
Wat de Magejutsu API afdwingt
- De bronvideo duurt 4 tot 30 seconden bij magejutsu en 4 tot 15 bij magejutsu-lite, de snellere en goedkopere variant, en bij magejutsu-feather, de goedkoopste en snelste, die alleen motion_transfer ondersteunt en rendert in 480p en 720p. De uitvoer volgt de lengte en de beeldverhouding van de bron.
- Elke aanvraag draait in de backend op dezelfde director. Kies motion_transfer om de performers opnieuw op te bouwen en de beweging te behouden, of object_swap om geselecteerde elementen te wijzigen en de rest van de shot te laten zoals gefilmd. De modus bepaalt ook hoe de bron wordt voorbereid: bij een motion transfer wordt de bewerking gestuurd door de beweging en het gezicht van elke vervangen performer, en bij een object swap wordt de bron bewerkt zoals gefilmd. Een clip die de begeleiding niet kan lezen, zoals een clip zonder persoon, wordt gerenderd vanuit de bron zoals gefilmd. Er zijn geen handmatige goedkeuringsstappen of conceptrenders.
- Stuur maximaal 30 referentie-afbeeldingen mee via image en additional_images. De director leest ze allemaal, en de bewerking krijgt de afbeeldingen die in de prompt worden gebruikt: maximaal 27 bij magejutsu, 9 bij magejutsu-lite en 8 bij magejutsu-feather.
- De prompt is optioneel: zonder prompt koppelt de director de referenties aan de bron op basis van zichtbaarheid en overeenkomst.
- De originele audio wordt standaard hersteld; zet keep_original_audio op false om de gegenereerde audio te behouden.
- De afbeeldingen vormen de vervanging; noem ze in de prompt op positie ("afbeelding 1 is de persoon links").
- De bronvideo is de enige video die een verzoek accepteert; een langere clip wordt geweigerd in plaats van ingekort.
Meer videomodellen
Andere API's voor videogeneratie op Mage
Melon API
Anime in beweging, met optionele audio
MiniMax-H3 API
Snelle open video met stereogeluid
Plum API
Geluid bij elke clip, tot 2K
Raspberry API
Characters tot leven gebracht vanaf een eerste frame
Wan Video v2.2 API
Open-weights video met een Lightning-variant
Berry API
Video die trouw blijft aan je referenties
FAQ
Veelgestelde vragen
Hoeveel kost de Magejutsu API?
Wat is het endpoint van de Magejutsu API?
Welke Magejutsu-modellen kan ik aanroepen?
Ondersteunt Magejutsu referentieafbeeldingen of personages?
Kan ik Magejutsu gebruiken vanuit Claude of ChatGPT?
Hoe lang worden Magejutsu-resultaten bewaard?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.