API do Mage · Modelo de vídeo
API Magejutsu
Refaça qualquer vídeo mantendo o movimento
POST https://api.mage.space/v1/magejutsu/generateResumo rápido
A API Magejutsu executa o Magejutsu e outras 2 variantes pelo Mage em POST https://api.mage.space/v1/magejutsu/generate. Uma requisição com as configurações padrão custa 1.856 Gems (cerca de US$ 1,856), sem assinatura. O Magejutsu aceita personagens salvos e referências por @handle no prompt.
- VídeoSaída
- 3Variantes
- 1,856Gems por clipe, padrão
- $1.856Aproximadamente, em USD
Visão geral
O que a API Magejutsu faz
Refaz um vídeo que você já tem: envie o clipe e as fotos de quem ou do que vai substituir o original, e o movimento, a câmera, o tempo e o som permanecem como foram filmados. As fontes têm de 4 a 30 segundos.
Refaz um vídeo existente: um diretor escreve o prompt de edição a partir da fonte, e uma etapa de edição de vídeo reconstrói quem e o que atua nele. Envie o vídeo de origem e as referências de substituição; o resultado mantém a duração, a proporção, o movimento e o som da origem.
Aceita image, additional_images e videos como entradas.
Início rápido
Chame a API Magejutsu
Defina MAGE_API_KEY, envie para /magejutsu/generate e consulte status_url até a solicitação ser concluída.
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 do Magejutsu
Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.
| model_id | Nome | Padrão |
|---|---|---|
| magejutsu | Magejutsu | Sim |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Opções
Parâmetros do Magejutsu
Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.
| Campo | Valores |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Entradas
Mídias que o Magejutsu aceita
Envie cada uma como URL https, data URL ou upload de até 100 MB.
| Campo | Função |
|---|---|
| image | A imagem de referência. |
| additional_images | Imagens de referência adicionais. |
| videos | Os vídeos de origem. |
Regras
O que a API Magejutsu exige
- O vídeo de origem deve ter de 4 a 30 segundos no magejutsu e de 4 a 15 no magejutsu-lite, a variante mais rápida e econômica, e no magejutsu-feather, a mais barata e rápida, que executa apenas motion_transfer e renderiza em 480p e 720p. O resultado segue a duração e a proporção do vídeo de origem.
- Toda solicitação executa o mesmo diretor no backend. Escolha motion_transfer para recriar os performers mantendo o movimento, ou object_swap para trocar elementos selecionados e manter o restante da cena como foi filmada. O modo também define como a fonte é preparada: no motion transfer, a edição é guiada pelo movimento e pelo rosto de cada performer substituído; no object swap, a fonte é editada como foi filmada. Um clipe que a orientação não consegue interpretar, como um sem nenhuma pessoa, é renderizado a partir da fonte como foi filmada. Não há etapas de aprovação manual nem renderizações de rascunho.
- Envie até 30 imagens de referência entre image e additional_images. O diretor lê todas, e a edição recebe as que o prompt usa: até 27 no magejutsu, 9 no magejutsu-lite e 8 no magejutsu-feather.
- O prompt é opcional: sem ele, o diretor associa as referências à fonte de acordo com a relevância e a compatibilidade.
- O áudio original é restaurado por padrão; defina keep_original_audio como false para manter o áudio gerado.
- As imagens são a substituição; mencione cada uma no prompt pela posição ("a imagem 1 é a pessoa à esquerda").
- O vídeo de origem é o único aceito por solicitação; um clipe mais longo é recusado em vez de cortado.
Mais modelos de vídeo
Outras APIs de geração de vídeo no Mage
API do Melon
Anime em movimento, com áudio opcional
API do MiniMax-H3
Vídeo aberto e rápido com som estéreo
API do Plum
Som em todos os clipes, até 2K
API do Raspberry
Personagens ganham vida a partir de um primeiro frame
API do Wan Video v2.2
Vídeo com pesos abertos e uma variante Lightning
API do Berry
Vídeo fiel às suas referências
Perguntas frequentes
Perguntas frequentes
Quanto custa a API Magejutsu?
Qual é o endpoint da API Magejutsu?
Quais modelos do Magejutsu posso chamar?
O Magejutsu aceita imagens de referência ou personagens?
Posso usar o Magejutsu no Claude ou no ChatGPT?
Por quanto tempo os resultados do Magejutsu ficam salvos?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.