API di Mage · Modello video
API Magejutsu
Rifai qualsiasi video mantenendone il movimento
POST https://api.mage.space/v1/magejutsu/generateIn breve
L'API Magejutsu esegue Magejutsu e altre 2 varianti tramite Mage su POST https://api.mage.space/v1/magejutsu/generate. Una richiesta con le impostazioni predefinite costa 1.856 Gems (circa 1,856 $), senza abbonamento. Magejutsu accetta personaggi salvati e riferimenti tramite @handle nel prompt.
- VideoOutput
- 3Varianti
- 1,856Gems per clip, predefinito
- $1.856Circa, in USD
Panoramica
Cosa fa l'API Magejutsu
Rifà un video che hai già: invii la clip e le foto di chi o cosa prende il posto del soggetto, e movimento, camera, tempi e suono restano quelli girati. I video di partenza durano da 4 a 30 secondi.
Rifà un video esistente: un regista scrive il prompt di modifica a partire dall'originale e un passaggio di video editing ricostruisce chi e cosa lo interpreta. Invii il video di partenza e i riferimenti sostitutivi; il risultato mantiene durata, formato, movimento e suono dell'originale.
Accetta image, additional_images, videos come input.
Guida rapida
Chiama l'API Magejutsu
Imposta MAGE_API_KEY, invia la richiesta a /magejutsu/generate e interroga status_url finché la richiesta non è completata.
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"])Modelli
Valori model_id di Magejutsu
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| magejutsu | Magejutsu | Sì |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Opzioni
Parametri di Magejutsu
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Input
Contenuti multimediali accettati da Magejutsu
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
| videos | I video di partenza. |
Regole
Cosa impone l'API Magejutsu
- Il video di partenza dura da 4 a 30 secondi su magejutsu e da 4 a 15 su magejutsu-lite, la variante più veloce ed economica, e su magejutsu-feather, la più economica e veloce in assoluto, che esegue solo motion_transfer e genera a 480p e 720p. Il risultato mantiene la durata e le proporzioni del video di partenza.
- Ogni richiesta usa lo stesso director nel backend. Scegli motion_transfer per ricostruire i performer mantenendo il movimento, oppure object_swap per cambiare gli elementi selezionati e lasciare il resto della scena così com'è stato girato. La modalità decide anche come viene preparata la sorgente: un motion transfer guida la modifica con il movimento e il volto di ogni performer sostituito, mentre un object swap modifica la sorgente così com'è stata girata. Una clip che la guida non riesce a leggere, ad esempio senza nessuna persona, viene renderizzata dalla sorgente così com'è stata girata. Non ci sono passaggi di approvazione manuale né render di bozza.
- Invia fino a 30 immagini di riferimento tra image e additional_images. Il director le legge tutte, e la modifica riceve quelle usate nel prompt: fino a 27 su magejutsu, 9 su magejutsu-lite e 8 su magejutsu-feather.
- Il prompt è facoltativo: senza, il director associa i riferimenti alla sorgente in base a rilevanza e corrispondenza.
- L'audio originale viene ripristinato di default: imposta keep_original_audio su false per mantenere l'audio generato.
- Le immagini sono le sostituzioni; citale nel prompt in base alla posizione ("l'immagine 1 è la persona a sinistra").
- Ogni richiesta accetta solo il video di partenza; una clip più lunga viene rifiutata, non tagliata.
Altri modelli video
Altre API per generare video su Mage
API di Melon
Anime in movimento, con audio opzionale
API MiniMax-H3
Video open veloce con audio stereo
API Plum
Audio su ogni clip, fino a 2K
API di Raspberry
Personaggi che prendono vita a partire da un primo fotogramma
API Wan Video v2.2
Video open-weights con variante Lightning
API Berry
Video fedeli ai tuoi riferimenti
FAQ
Domande frequenti
Quanto costa l'API Magejutsu?
Qual è l'endpoint dell'API Magejutsu?
Quali modelli Magejutsu posso chiamare?
Magejutsu supporta immagini di riferimento o personaggi?
Posso usare Magejutsu da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Magejutsu?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.