Introducción
MP4 obligatorio de hasta 15 segundos sin cortes. Las personas que se reemplazarán deben verse en el primer fotograma. Arreglo obligatorio de 1–4 fotos, ilustraciones o renders 3D, una imagen por personaje. Conviene mostrar el cuerpo completo.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Editor | ComfyUI |
| Endpoints | video-edit |
| Entradas | MP4 y 1–4 imágenes; asignación opcional |
| Clip de origen | Una toma, máximo 15 segundos |
| Resolución | 480p / 540p / 768p predeterminado / 1080p |
| Audio | Audio original conservado |
| Ejecución | Asíncrona; cobro por segundos de origen |
Funciones y aspectos destacados
Aprovecha el orden de las imágenes
En la prueba de los dos ciclistas, la primera referencia corresponde a la persona de camisa azul a la izquierda y la segunda a la de rojo a la derecha. Escribe esas descripciones en líneas separadas del prompt, siguiendo el orden de las imágenes. Revisa cada asignación por separado; que cambie el grupo no demuestra que ambos papeles estén bien asignados.
Revisa también la silueta
La prueba de estudio reemplaza a una bailarina adulta filmada por una heroína pelirroja dibujada. Cambian el cabello y el vestuario en todo el cuerpo, mientras la pose original guía el movimiento. Revisa mangas, cintura y cabello en acción; una cara lograda no basta para aprobar al personaje completo.
Comprueba el final de la toma
Esta imagen vuelve a la misma prueba de los dos ciclistas a los 3 segundos. Compara bicicletas, distancias y calle además de los personajes nuevos, y reproduce el final: esta fuente de cinco segundos produjo unos cuatro segundos y medio. Planea el montaje con la duración entregada, sin alargar la vista previa para aparentar duraciones iguales.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | MP4 obligatorio de hasta 15 segundos sin cortes. Las personas que se reemplazarán deben verse en el primer fotograma. mínimo 1 caracteres |
reference_image_urls | Sí | Arreglo obligatorio de 1–4 fotos, ilustraciones o renders 3D, una imagen por personaje. Conviene mostrar el cuerpo completo. mínimo 1 elementos · máximo 4 elementos |
prompt | No | Opcional: una persona por línea, en el orden de las imágenes. máximo 600 caracteres |
resolution | No | 480p, 540p, 768p o 1080p; predeterminado 768p. Los niveles superiores aumentan la tarifa por segundo. |
seed | No | Entero opcional de 0 a 2147483647. Conserva la fuente aleatoria para comparar un cambio por vez, sin garantizar los mismos fotogramas. |
Precios
El reemplazo de personajes cobra los segundos de origen redondeados hacia arriba, con mínimo de 3 segundos. La resolución fija la tarifa, las imágenes están incluidas y las tareas fallidas son gratuitas. Fuentes de más de 15 segundos se rechazan antes de facturar.
| Especificación | Precio |
|---|---|
| $0.105 / segundo |
| $0.119 / segundo |
| $0.14 / segundo |
| $0.28 / segundo |
Casos de uso
Reparto de cortometrajes
Prueba otro personaje sobre la actuación autorizada de un intérprete.
Varias personas a la vez
Asigna imágenes distintas a dos ciclistas manteniendo bicicletas y calle.
Del dibujo a la actuación
Usa un personaje ilustrado o 3D sobre los movimientos de un adulto.
Variantes para campañas
Compara personajes ficticios con la misma toma para anuncios o redes sociales.
Guía de prompts y consejos prácticos
Comprueba las autorizaciones
Confirma los derechos de la grabación y de cada identidad; todas las personas deben tener al menos 18 años. Usa tu imagen, actores con autorización firmada o personajes ficticios que hayas generado.
Ordena las referencias
Prepara 1–4 imágenes, preferentemente de cuerpo completo, y describe una persona por línea en el mismo orden.
Revisa el nuevo reparto
Ejecuta la solicitud y comprueba identidad, vestuario, movimientos y duración antes de publicar.
Introducción
MP4 obligatorio de hasta 15 segundos sin cortes. Las personas que se reemplazarán deben verse en el primer fotograma. Arreglo obligatorio de 1–4 fotos, ilustraciones o renders 3D, una imagen por personaje. Conviene mostrar el cuerpo completo.
Funcionamiento
Envía los campos públicos a openjutsu/character-swap/video-edit y guarda el identificador de tarea. Consulta su estado hasta éxito o fallo y recupera el video desde los archivos de resultado de la tarea exitosa. Los cambios de personaje medidos tardaron aproximadamente 1–4 minutos.
Parámetros
video_url: MP4 obligatorio de hasta 15 segundos sin cortes. Las personas que se reemplazarán deben verse en el primer fotograma.reference_image_urls: Arreglo obligatorio de 1–4 fotos, ilustraciones o renders 3D, una imagen por personaje. Conviene mostrar el cuerpo completo.- prompt: Opcional: una persona por línea, en el orden de las imágenes. Si se omite, una imagen apunta a la persona principal; varias siguen la aparición y, si coinciden, de izquierda a derecha. Las referencias sin objetivo se ignoran y el resto permanece.
- resolution: 480p, 540p, 768p o 1080p; predeterminado 768p. Los niveles superiores aumentan la tarifa por segundo. Medidas horizontales observadas: 864×480, 960×544, 1376×768, 1920×1056.
- seed: Entero opcional de 0 a 2147483647. Conserva la fuente aleatoria para comparar un cambio por vez, sin garantizar los mismos fotogramas.
Facturación
El reemplazo de personajes cobra los segundos de origen redondeados hacia arriba, con mínimo de 3 segundos. La resolución fija la tarifa, las imágenes están incluidas y las tareas fallidas son gratuitas. Fuentes de más de 15 segundos se rechazan antes de facturar.
Consejos
Utiliza referencias de cuerpo completo y asignaciones claras. Para otras duraciones, ante un error genérico, recorta a una cantidad entera de segundos y reintenta. Revisa también la ropa.
Límites
- Solo puedes usar tu rostro o el de adultos que hayan dado su consentimiento. Celebridades, conocidos y fotos de internet también requieren permiso. No coloques a personas reales en escenas que no hayan aceptado.
- La fuente debe ser un MP4 continuo de hasta 15 segundos, con las personas que se reemplazarán visibles desde el primer fotograma. No admite montajes con cortes.
- El vestuario no siempre reproduce la referencia: una prueba con la foto de una mujer adulta generó un vestido blanco largo en vez de la ropa de la imagen.
- Para reemplazar personajes, las fuentes de unos 5.17 segundos (5.13–5.20 segundos) se recortan automáticamente a exactamente 5 segundos antes del procesamiento, quitando unos 4 fotogramas iniciales. No necesitas recortarlas tú; se facturan 5 segundos y se libera el segundo adicional reservado al calcular 6 segundos. Si una fuente de otra duración falla con un error genérico, recórtala a segundos enteros exactos y vuelve a intentar; los reemplazos de personajes fallidos no tienen costo.
- En pruebas, una fuente de 5 segundos produjo unos 4.5 segundos; una de 8 conservó los 8 segundos. Comprueba la duración para el montaje.
Usa únicamente tu rostro o el de personas que hayan dado su consentimiento y material donde todos tengan 18 años o más; una foto pública no es autorización. No suplantes identidades, no engañes ni coloques a personas reales en escenas que no hayan aprobado. Antes del primer uso en la web debes marcar la aceptación de estas reglas; llamar a la API implica aceptar las mismas reglas. El contenido que las incumpla se retirará y la cuenta podría suspenderse.
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": "comfyui/openjutsu-character-swap/video-edit",
"input": {
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "768p",
"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.




