API Mage · Modèle vidéo
API Magejutsu
Redonnez vie à n'importe quelle vidéo en gardant son mouvement
POST https://api.mage.space/v1/magejutsu/generateEn un coup d’œil
L'API Magejutsu exécute Magejutsu et 2 autres variantes via Mage à l'adresse POST https://api.mage.space/v1/magejutsu/generate. Une requête avec les paramètres par défaut coûte 1 856 Gems (environ 1,856 $), sans abonnement. Magejutsu accepte les personnages enregistrés et les références par @handle dans le prompt.
- VidéoSortie
- 3Variantes
- 1,856Gems par clip, par défaut
- $1.856Environ, en USD
Présentation
Ce que fait l'API Magejutsu
Remplace les personnages ou éléments d'une vidéo existante : envoyez le clip et des photos de ce qui doit les remplacer, et le mouvement, la caméra, le rythme et le son restent tels que filmés. Les sources durent de 4 à 30 secondes.
Refait une vidéo existante : un réalisateur rédige le prompt de montage à partir de la source, puis une passe d'édition vidéo reconstruit qui et quoi y apparaît. Envoyez la vidéo source et les références de remplacement ; le résultat garde la durée, le format, le mouvement et le son de la source.
Elle accepte image, additional_images et videos en entrée.
Démarrage rapide
Appeler l'API Magejutsu
Définissez MAGE_API_KEY, envoyez la requête à /magejutsu/generate, puis interrogez status_url jusqu'à la fin de la requête.
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"])Modèles
Valeurs model_id de Magejutsu
Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.
| model_id | Nom | Par défaut |
|---|---|---|
| magejutsu | Magejutsu | Oui |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Options
Paramètres de Magejutsu
Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.
| Champ | Valeurs |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Entrées
Médias acceptés par Magejutsu
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| image | L'image de référence. |
| additional_images | Images de référence supplémentaires. |
| videos | Les vidéos sources. |
Règles
Ce que l'API Magejutsu impose
- La vidéo source dure de 4 à 30 secondes sur magejutsu, et de 4 à 15 sur magejutsu-lite, la variante plus rapide et moins chère, ainsi que sur magejutsu-feather, la plus économique et la plus rapide, qui ne gère que motion_transfer et génère en 480p et 720p. Le résultat reprend la durée et le format d'image de la source.
- Chaque requête exécute le même réalisateur en backend. Choisis motion_transfer pour reconstruire les interprètes tout en conservant le mouvement, ou object_swap pour modifier certains éléments en gardant le reste du plan tel qu'il a été filmé. Le mode détermine aussi la façon dont la source est préparée : un transfert de mouvement guide la modification avec les mouvements et le visage de chaque interprète remplacé, tandis qu'un remplacement d'objet modifie la source telle qu'elle a été filmée. Un clip que le guidage ne peut pas lire, par exemple sans aucune personne, est rendu à partir de la source telle qu'elle a été filmée. Il n'y a aucune étape d'approbation manuelle ni rendu provisoire.
- Envoie jusqu'à 30 images de référence via image et additional_images. Le réalisateur les lit toutes, et le montage reçoit celles que le prompt utilise : jusqu'à 27 sur magejutsu, 9 sur magejutsu-lite et 8 sur magejutsu-feather.
- Le prompt est facultatif : sans prompt, le réalisateur associe les références à la source selon leur importance et leur adéquation.
- L'audio d'origine est restauré par défaut ; définis keep_original_audio sur false pour conserver l'audio généré.
- Les images sont les éléments de remplacement ; mentionnez chacune dans le prompt par sa position (« l'image 1 est la personne à gauche »).
- La vidéo source est la seule acceptée par requête ; un clip trop long est refusé et non coupé.
Plus de modèles vidéo
Autres API de génération vidéo sur Mage
API Melon
Anime en mouvement, avec audio en option
API MiniMax-H3
Vidéo ouverte rapide avec son stéréo
API Plum
Du son sur chaque clip, jusqu'en 2K
API Raspberry
Des personnages animés à partir d'une première image
API Wan Video v2.2
Vidéo open-weights avec une variante Lightning
API Berry
Une vidéo fidèle à tes références
FAQ
Questions fréquentes
Combien coûte l'API Magejutsu ?
Quel est le endpoint de l'API Magejutsu ?
Quels modèles Magejutsu puis-je appeler ?
Magejutsu prend-il en charge les images de référence ou les personnages ?
Puis-je utiliser Magejutsu depuis Claude ou ChatGPT ?
Combien de temps les résultats Magejutsu sont-ils conservés ?
Lance-toi avec Mage
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.