Introducción
MiniMax H3 Character Swap Video edit cambia a una persona de un clip corto por el personaje de una sola imagen.
Funciones y aspectos destacados
- Envía tu clip, la imagen del personaje y la persona que se va a reemplazar; la plataforma construye la instrucción con la que se entrenó el adaptador («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»).
- El adaptador Character Swap V1.5 se carga con fuerza 1.
- Con el adaptador, el cambio seguía el original golpe a golpe; el mismo modelo base sin él perdía la interpretación a mitad de camino y una vez dejó al hombre original en el plano como transeúnte.
- En un plano con dos personas, solo cambió la persona indicada.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | El clip de origen (MP4). Se usan hasta 15 segundos; una toma continua sin cortes da mejores resultados. mínimo 1 caracteres |
image_url | Sí | Una imagen del nuevo personaje: una foto, un render 3D o un dibujo. El cuerpo completo sobre fondo liso da la mejor coincidencia de rostro, pelo y ropa. mínimo 1 caracteres |
prompt | No | A quién reemplazar, en pocas palabras, como «la mujer de la izquierda» o «el hombre de la camisa blanca». Déjalo vacío para reemplazar a la persona principal. máximo 300 caracteres |
aspect_ratio | No | Forma de la salida (predeterminado 16:9). Elige la misma forma que tu clip de origen. |
resolution | No | 480p (predeterminado), 540p, 768p o 1080p. Las resoluciones más altas cuestan más por segundo; 480p es la forma económica de revisar primero un cambio. |
duration_seconds | No | Duración de salida de 3 a 15 segundos (predeterminado 5). Ponla igual a la duración de tu clip para usar toda la actuación. |
seed | No | Mantiene comparables las ejecuciones mientras cambias una entrada a la vez. No promete un clip idéntico cuadro por cuadro. |
Precios
Se cobra por segundo de salida más por segundo de video de origen (cada segundo iniciado cuenta, hasta 15), y una pequeña tarifa por la imagen del personaje; la tarifa depende de la resolución.
| Especificación | Precio |
|---|---|
| $0.06 / segundo |
| $0.09 / segundo |
| $0.12 / segundo |
| $0.24 / segundo |
Casos de uso
- Reemplazar a una persona intérprete con autorización firmada por otro aspecto en la misma toma.
- Colocar un personaje sintético que hayas generado en metraje de acción real que hayas grabado.
- Vistas previas rápidas de ideas de vestuario o de casting antes de repetir una toma.
Guía de prompts y consejos prácticos
- Las referencias dibujadas y en 3D salen como personas de acción real con el mismo pelo, colores y ropa.
- Algunas ejecuciones conservan la ropa original, se alejan del rostro de referencia o añaden figurantes al fondo; vuelve a ejecutar con otra semilla u otro clip.
- Úsalo solo con material e identidades que tengas autorización para procesar: tú mismo, una persona intérprete con autorización firmada o una persona sintética que hayas generado. No lo uses para colocar a una persona real en material de carácter íntimo o difamatorio sin su consentimiento inequívoco e informado, para suplantar a nadie, ni con material de menores de edad. Que una fotografía sea pública no equivale a consentimiento, y el consentimiento no se transfiere entre proyectos.
Inicio rápido de la 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"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.















