Introducción
Video de origen obligatorio, sin cortes y de 15 segundos como máximo. Su duración determina el cobro y su audio permanece. change es predeterminado y reemplaza el objetivo. background lo mantiene y cambia lo demás; people sirve para conservar personas.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Editor | ComfyUI |
| Endpoints | video-edit |
| Entradas | Video, objetivo, texto y/o una referencia |
| Clip de origen | Toma única, hasta 15 segundos |
| Resolución | 480p / 540p / 768p por defecto / 1080p |
| Audio | Pista de origen preservada |
| Ejecución | Tarea asíncrona; costo según duración de entrada |
Funciones y aspectos destacados
Separa el cambio de color del corte
La prueba del invernadero pidió cabello corto rubio platino. El resultado cambió el color, pero conservó buena parte del rizo y del largo originales. Evalúa cada atributo por separado: una coloración lograda no confirma que también se haya conseguido el corte solicitado.
Observa a quien está junto al objetivo
En la prueba de la cava, blouse es el objetivo y una camisa blanca de lino es el reemplazo solicitado. Compara la prenda de la mujer junto con el hombre de al lado y las copas levantadas. Así revisas el alcance del cambio sin suponer que todos los píxeles no seleccionados serán idénticos.
Nombra lo que debe quedar al cambiar el lugar
En modo background, people es el objetivo protegido y el prompt describe una terraza nocturna en una azotea. El ejemplo de la cava mantiene a la pareja y sus copas mientras cambia el entorno por luces urbanas. Revisa los contornos y los espacios entre los brazos, donde se unen el escenario anterior y el nuevo.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | Video de origen obligatorio, sin cortes y de 15 segundos como máximo. Su duración determina el cobro y su audio permanece. mínimo 1 caracteres |
edit_target | Sí | Etiqueta corta según lo que ves, como hair, jacket o car. Separa varios objetivos con comas; en background son los elementos que quedan. mínimo 1 caracteres · máximo 120 caracteres |
edit_mode | No | change es predeterminado y reemplaza el objetivo. background lo mantiene y cambia lo demás; people sirve para conservar personas. |
prompt | No | Describe el aspecto nuevo o el lugar de destino en background. Debes incluir esto o |
reference_image_url | No | Referencia opcional de ropa, peinado, producto o lugar. Se aconseja una imagen del artículo solo más texto; una referencia de persona completa no reprodujo la prenda esperada. mínimo 1 caracteres |
resolution | No | 480p, 540p, 768p predeterminado o 1080p. El nivel aumenta la tarifa; las medidas horizontales fueron 864×480, 960×544, 1376×768 y 1920×1056. |
seed | No | Número entero opcional entre 0 y 2147483647. Una fuente aleatoria compartida ayuda a comparar un ajuste por vez sin prometer repetición fotograma a fotograma. |
Precios
La edición de objetos factura segundos de entrada redondeados, con un piso de 3 segundos. La resolución determina la tarifa sin recargo por referencia. Los fallos no se cobran y las fuentes superiores a 15 segundos se rechazan antes de cualquier cargo.
| Especificación | Precio |
|---|---|
| $0.105 / segundo |
| $0.119 / segundo |
| $0.14 / segundo |
| $0.28 / segundo |
Casos de uso
Opciones de vestuario
Compara cuero y lino en una grabación autorizada de una persona adulta.
Pruebas de color de cabello
Ensaya el platino y observa si quedan el largo y los rizos originales.
Otro lugar para el brindis
Conserva personas y copas al mover una bodega a una azotea nocturna.
Conceptos de producto
Prueba un reemplazo con imagen del artículo y descripción; valida el resultado antes de usarlo en una campaña.
Guía de prompts y consejos prácticos
Confirma el derecho a editar
Revisa los permisos de rostros, fotos y videos; todas las personas representadas deben ser mayores de 18 años o tener 18 cumplidos.
Elige objetivo y modo
Escribe en
edit_targetuna etiqueta visual breve. change reemplaza ese elemento y background lo conserva cambiando lo que lo rodea.Describe el nuevo aspecto
Proporciona prompt,
reference_image_urlo ambos. En background indica el nuevo lugar; para ropa conviene una imagen de la prenda sola y texto claro.Comprueba la edición
Cuando termine la tarea asíncrona, revisa el objetivo, los detalles cercanos y el audio.
Introducción
Video de origen obligatorio, sin cortes y de 15 segundos como máximo. Su duración determina el cobro y su audio permanece. change es predeterminado y reemplaza el objetivo. background lo mantiene y cambia lo demás; people sirve para conservar personas.
Funcionamiento
Llama a openjutsu/object-swap/video-edit con los datos públicos y conserva el ID recibido. Consulta la tarea hasta el estado final; si termina bien, obtén el clip editado de los archivos de resultado y examínalo antes de incorporarlo a tu edición.
Parámetros
video_url: Video de origen obligatorio, sin cortes y de 15 segundos como máximo. Su duración determina el cobro y su audio permanece.edit_target: Etiqueta corta según lo que ves, como hair, jacket o car. Separa varios objetivos con comas; en background son los elementos que quedan.edit_mode: change es predeterminado y reemplaza el objetivo. background lo mantiene y cambia lo demás; people sirve para conservar personas.- prompt: Describe el aspecto nuevo o el lugar de destino en background. Debes incluir esto o
reference_image_url; también pueden combinarse. reference_image_url: Referencia opcional de ropa, peinado, producto o lugar. Se aconseja una imagen del artículo solo más texto; una referencia de persona completa no reprodujo la prenda esperada.- resolution: 480p, 540p, 768p predeterminado o 1080p. El nivel aumenta la tarifa; las medidas horizontales fueron 864×480, 960×544, 1376×768 y 1920×1056.
- seed: Número entero opcional entre 0 y 2147483647. Una fuente aleatoria compartida ayuda a comparar un ajuste por vez sin prometer repetición fotograma a fotograma.
Facturación
La edición de objetos factura segundos de entrada redondeados, con un piso de 3 segundos. La resolución determina la tarifa sin recargo por referencia. Los fallos no se cobran y las fuentes superiores a 15 segundos se rechazan antes de cualquier cargo.
Consejos
Separa el nombre del objeto actual de la descripción del reemplazo. Para referencias, conviene un artículo aislado con texto. Si aparece un error genérico con una fuente de otra duración, recorta la fuente a segundos enteros exactos y vuelve a probar.
Límites
- Editar objetos también exige consentimiento de los adultos visibles. Usa tu rostro o uno autorizado; las fotos de famosos, conocidos o internet no son utilizables solo por estar disponibles. No suplantes ni induzcas a error.
- Se acepta una sola toma sin interrupciones de hasta 15 segundos. Divide las secuencias de varios planos antes de enviarlas.
- La prueba de cabello logró color platino, pero conservó largo y rizos pese a pedirlo corto. Cambiar color puede ser más fácil que cambiar forma.
- El único ensayo con una referencia de persona completa no reprodujo la prenda deseada. Se aconseja usar la prenda aislada junto con texto; no es una garantía comprobada.
- Al editar objetos, la plataforma elimina automáticamente unos 4 fotogramas del inicio de las fuentes de aproximadamente 5.17 segundos (5.13–5.20 segundos), dejando exactamente 5 segundos para procesar. No hace falta un corte manual: se facturan 5 segundos y se libera el segundo sobrante de la reserva inicial de 6 segundos. Si una fuente con otra duración presenta un error genérico, córtala a una cantidad exacta de segundos enteros y reenvíala; las ediciones de objetos fallidas no generan cargos.
Sube solo tu rostro o rostros usados con permiso y asegúrate de que todas las personas del material tengan 18 años cumplidos; las imágenes públicas no equivalen a consentimiento. Se prohíben la suplantación y los usos engañosos. La web exige marcar la aceptación antes de ejecutar por primera vez, y usar la API supone aceptar esas mismas reglas. El contenido infractor se retirará y tu cuenta puede 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-object-swap/video-edit",
"input": {
"edit_mode": "change",
"edit_target": "example",
"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.




