Head Swap API

Head Swap sustituye la cabeza entera de la persona de la imagen de destino por la cabeza de una foto de referencia. Se trasladan el rostro, el peinado, el color de pelo y la silueta del cráneo; el cuerpo, la ropa, la pose, la luz y el fondo del destino quedan como estaban.

La solicitud son dos URL de imagen y un seed opcional: image_url es el cuerpo que se conserva y reference_image_url aporta la cabeza. No hay prompt, máscara ni control de intensidad, y cada solicitud devuelve una imagen.

Llevar la cabeza completa de un personaje a una toma existente

Head Swap cambia más que la identidad facial: es el alcance adecuado cuando el pelo, el color y la silueta de la cabeza del personaje que llega tienen que viajar con él. Eso lo hace útil para cambiar de personaje, conceptos de vestuario y tratamientos de continuidad en los que el peinado del destino no debe sobrevivir.

La transición del cuello es la prueba de aceptación

Elige material de origen con ángulo de cámara y dirección de luz compatibles y con el cuello visible. Revisa a tamaño completo el nacimiento del pelo, las orejas, la mandíbula, la costura del cuello y la continuidad de las sombras antes de aceptar un resultado: esos bordes revelan si las dos imágenes encajan de verdad.

Trabaja con un par de imágenes controlado

Empieza con una sola persona clara en cada imagen y evita desenfoques fuertes, oclusiones o perfiles extremos. Cuando el pelo y la silueta propios del destino son esenciales para la toma, elige Face Swap en lugar de forzar un tratamiento de cabeza completa.

Sustituir la cabeza entera, no solo el rostro

Usa este endpoint cuando el peinado, el color de pelo y la silueta de la cabeza de la persona que llega tienen que venir con ella. Revisa a tamaño completo el nacimiento del pelo, las orejas y la costura del cuello antes de aceptar el resultado; si el pelo propio del destino forma parte de la toma, Face Swap es la herramienta más acotada.

Cambiar la cabeza de una toma de cuerpo que ya te gusta

Cuando la ropa, la pose y la luz de una imagen ya funcionan, cambiar la cabeza es más barato y predecible que regenerar toda la imagen y esperar que la composición sobreviva.

Tomas de vestuario y cosplay

Pon la cabeza y el peinado propios de un personaje sobre un cuerpo que lleva el vestuario que generaste. El uniforme de sirvienta, la pose y el set de cafetería quedan exactamente como estaban, así que el trabajo de vestuario sobrevive a la pasada.

Cualquier escena con un rostro con consentimiento

Lleva una cabeza que tienes autorización para usar a imágenes que produjiste tú, muestren lo que muestren. El endpoint no trata el material de forma distinta: lo que manda es el requisito de consentimiento de los límites que siguen, y no es un trámite.

# 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": "spicyapi/head-swap-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png"
  }
}'

# 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.