Introdução
MiniMax H3 Character Swap Video edit recria uma pessoa de um clipe curto com o personagem de uma única imagem.
Recursos e destaques
- Envie seu clipe, a imagem do personagem e quem deve ser substituído; a plataforma monta a instrução com a qual o adaptador foi treinado («Replace ... with the character in the picture; keep the reference character's face, hair and clothing; follow the source performance's pose, gaze, expression and movement; preserve the scene and the other people»).
- O adaptador Character Swap V1.5 carrega com força 1.
- Com o adaptador, a troca seguia a cena original batida a batida; o mesmo modelo base sem ele perdia a atuação no meio do caminho e uma vez deixou o homem original no quadro como transeunte.
- Em um plano com duas pessoas, só a pessoa indicada mudou.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O clipe de origem (MP4). Até 15 segundos são usados; uma tomada contínua, sem cortes, funciona melhor. pelo menos 1 caracteres |
image_url | Sim | Uma imagem do novo personagem: uma foto, um render 3D ou um desenho. Corpo inteiro em fundo liso dá a melhor correspondência de rosto, cabelo e roupa. pelo menos 1 caracteres |
prompt | Não | Quem substituir, em poucas palavras, como "a mulher à esquerda" ou "o homem de camisa branca". Deixe vazio para substituir a pessoa principal. no máximo 300 caracteres |
aspect_ratio | Não | Formato da saída (padrão 16:9). Escolha o mesmo formato do seu clipe de origem. |
resolution | Não | 480p (padrão), 540p, 768p ou 1080p. Faixas mais altas custam mais por segundo; 480p é a forma barata de testar uma troca antes. |
duration_seconds | Não | Duração da saída de 3 a 15 segundos (padrão 5). Defina igual à duração do seu clipe para usar toda a atuação. |
seed | Não | Mantém as execuções comparáveis enquanto você muda uma entrada de cada vez. Não promete um clipe idêntico quadro a quadro. |
Preços
Cobrado por segundo de saída mais por segundo de vídeo de origem (cada segundo iniciado conta, até 15), mais uma pequena taxa pela imagem do personagem; a tarifa depende da resolução.
| Especificação | Preço |
|---|---|
| $0.06 / segundo |
| $0.09 / segundo |
| $0.12 / segundo |
| $0.24 / segundo |
Casos de uso
- Reescalar um intérprete com autorização assinada com outro visual na mesma cena.
- Colocar um personagem sintético que você gerou em filmagens reais que você gravou.
- Prévias rápidas de ideias de figurino ou de elenco antes de uma nova gravação.
Guia de prompt e dicas práticas
- Referências desenhadas e animadas em 3D saem como pessoas reais com o mesmo cabelo, as mesmas cores e a mesma roupa.
- Algumas execuções mantêm a roupa original, se afastam do rosto da referência ou acrescentam figurantes ao fundo; rode de novo com outra seed ou com outro clipe.
- Use só em filmagens e semelhanças que você está autorizado a processar: você mesmo, um intérprete com autorização assinada, ou uma pessoa sintética que você gerou. Não use para colocar uma pessoa real em filmagens de teor íntimo ou difamatório sem o consentimento expresso e informado dessa pessoa, para se passar por outra pessoa, nem em qualquer filmagem de menor de idade. Uma foto ser pública não é consentimento, e o consentimento não é transferível entre projetos.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-character-swap/video-edit",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "480p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.















