API de Mage · Modelo de video
API de Magejutsu
Cambia el reparto de cualquier video y conserva su movimiento
POST https://api.mage.space/v1/magejutsu/generateDe un vistazo
La API de Magejutsu ejecuta Magejutsu y otras 2 variantes a través de Mage en POST https://api.mage.space/v1/magejutsu/generate. Una solicitud con los ajustes por defecto cuesta 1.856 Gems (unos 1,856 $), sin suscripción. Magejutsu admite personajes guardados y referencias mediante @handle en el prompt.
- VideoResultado
- 3Variantes
- 1,856Gems por clip, predeterminado
- $1.856Aprox., en USD
Resumen
Qué hace la API de Magejutsu
Cambia el reparto de un video que ya tienes: envía el clip y fotos de quién o qué lo sustituye, y el movimiento, la cámara, el ritmo y el sonido se mantienen tal como se grabaron. Los videos de origen duran de 4 a 30 segundos.
Rehace un video existente: un director redacta el prompt de edición a partir del original y una pasada de edición de video reconstruye quién y qué lo protagoniza. Envía el video original y las referencias de reemplazo; el resultado mantiene la duración, la proporción, el movimiento y el sonido del original.
Acepta image, additional_images y videos como entradas.
Inicio rápido
Llama a la API de Magejutsu
Define MAGE_API_KEY, envía la solicitud a /magejutsu/generate y consulta status_url hasta que se complete.
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"])Modelos
Valores de model_id de Magejutsu
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| magejutsu | Magejutsu | Sí |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Opciones
Parámetros de Magejutsu
Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.
| Campo | Valores |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Entradas
Archivos de entrada que acepta Magejutsu
Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.
| Campo | Rol |
|---|---|
| image | La imagen de referencia. |
| additional_images | Imágenes de referencia adicionales. |
| videos | Los videos de origen. |
Reglas
Qué límites aplica la API de Magejutsu
- El vídeo de origen puede durar de 4 a 30 segundos en magejutsu y de 4 a 15 en magejutsu-lite, la variante más rápida y económica, y en magejutsu-feather, la más económica y rápida, que solo ejecuta motion_transfer y renderiza en 480p y 720p. El resultado mantiene la duración y la relación de aspecto del original.
- Cada solicitud ejecuta el mismo director en el backend. Elige motion_transfer para reconstruir a los intérpretes y mantener el movimiento, o object_swap para cambiar elementos seleccionados y conservar el resto del plano tal como se grabó. El modo también decide cómo se prepara el material de origen: una transferencia de movimiento guía la edición con el movimiento y el rostro de cada intérprete reemplazado, y un intercambio de objetos edita el material de origen tal como se grabó. Un clip que la guía no puede interpretar, como uno en el que no aparece ninguna persona, se renderiza a partir del material de origen tal como se grabó. No hay pasos de aprobación manual ni renders de borrador.
- Envía hasta 30 imágenes de referencia entre image y additional_images. El director las lee todas y la edición recibe las que usa el prompt: hasta 27 en magejutsu, 9 en magejutsu-lite y 8 en magejutsu-feather.
- El prompt es opcional: si no lo incluyes, el director asigna las referencias al material de origen según su protagonismo y su encaje.
- El audio original se restaura de forma predeterminada; establece keep_original_audio en false para conservar el audio generado.
- Las imágenes son el reemplazo; menciona cada una en el prompt por su posición («la imagen 1 es la persona de la izquierda»).
- El video de origen es el único que se acepta en una solicitud; un clip más largo se rechaza en lugar de recortarse.
Más modelos de vídeo
Otras API de generación de vídeo en Mage
API de Melon
Anime en movimiento, con audio opcional
API de MiniMax-H3
Video abierto y rápido con sonido estéreo
API de Plum
Sonido en cada clip, hasta 2K
API de Raspberry
Personajes que cobran vida desde un primer fotograma
API de Wan Video v2.2
Vídeo de pesos abiertos con una variante Lightning
API de Berry
Vídeo fiel a tus referencias
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Magejutsu?
¿Cuál es el endpoint de la API de Magejutsu?
¿Qué modelos de Magejutsu puedo usar?
¿Magejutsu admite imágenes de referencia o personajes?
¿Puedo usar Magejutsu desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Magejutsu?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.