Introducción
Qué hace este endpoint
Recibe una foto y devuelve una copia con hasta tres caras restauradas y más nítidas, empezando por la más grande. Todo lo que está fuera de las caras se deja como estaba, y la resolución no cambia. No hay prompt.
Entradas que importan
image_url es la foto: un archivo JPEG, PNG o WebP subido, o una URL pública. `Elige para Face Enhancer una cara real, visible y suficientemente grande en la imagen; la restauración de detalles faciales en una foto con Face Enhancer aprovecha mejor esos detalles que una cara lejana u oculta. Elige para Face Enhancer una cara real, visible y suficientemente grande en la imagen; la restauración de detalles faciales en una foto con Face Enhancer aprovecha mejor esos detalles que una cara lejana u oculta.
Qué recibes
Una imagen por solicitud, con la misma resolución que enviaste, servida desde el almacenamiento de la plataforma cuando termina la tarea. Para más píxeles, usa /models/image-upscaler-v1.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoint | Edición de imagen |
| Caras | Hasta tres, empezando por la más grande |
| Lo demás | Se deja como estaba |
| Controles | Sin prompt: solo el formato de archivo |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto a restaurar: un archivo JPEG, PNG o WebP subido, o un enlace público al archivo. mínimo 1 caracteres |
output_format | No | jpeg (predeterminado), png o webp. png evita otra ronda de compresión con pérdida, pero el archivo pesa más. |
Precios
$0.012 / imagen
Se cobra un precio fijo por imagen. El formato de salida no cambia el precio, y las solicitudes fallidas no se cobran.
Casos de uso
Fotos que se redimensionaron y se volvieron a comprimir
Las fotos que pasaron por una app de chat, un feed social o varias rondas de guardado pierden detalle primero en la cara. Pásalas una vez para recuperar ojos, cejas, barba y textura de la piel.
Fotos de perfil y de equipo
Limpia un retrato un poco blando antes de publicarlo en un perfil, una página de equipo o una biografía de ponente. El encuadre, la iluminación y el fondo quedan como se tomaron.
Antes de un diseño más grande
Primero deja las caras limpias y después usa Image Upscaler en /models/image-upscaler-v1 si la foto también necesita más píxeles para un banner o una impresión.
Guía de prompts y consejos prácticos
Revisa las caras
Elige para Face Enhancer una cara real, visible y suficientemente grande en la imagen; la restauración de detalles faciales en una foto con Face Enhancer aprovecha mejor esos detalles que una cara lejana u oculta. Las caras muy tapadas, muy pequeñas o extremadamente borrosas, y las caras ilustradas o de anime, mejoran menos.
Envía
image_urlimage_urles la foto, como archivo JPEG, PNG o WebP subido o como URL pública. Agregaoutput_formatsi quieres png o webp en lugar de jpeg.Consulta y compara
La llamada es asíncrona: crea la tarea, consúltala hasta que termine y descarga la imagen desde el almacenamiento de la plataforma. Compárala con tu original a tamaño completo, sobre todo alrededor de los ojos y la piel.
Introducción
Face Enhancer restaura y afina las caras de una foto. Encuentra hasta tres caras, empezando por la más grande, y reconstruye el detalle que la compresión, el redimensionado o el desenfoque se llevaron: ojos, cejas, barba y textura de la piel. Todo lo que está fuera de las caras se deja como estaba, y la imagen vuelve con la misma resolución que enviaste. No hay prompt ni nada que ajustar aparte del formato de archivo.
Solicitud
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
image_url es el único campo obligatorio. output_format es jpeg por defecto; cámbialo a png o webp si lo prefieres.
Qué cambia y qué se mantiene
Cambian las caras; el resto de la foto no. En nuestra prueba tomamos un retrato JPEG de 720×404 de un hombre en un bar y lo degradamos a propósito: lo reducimos a la mitad, lo volvimos a ampliar y lo comprimimos mucho. Volvió en 720×404 después de unos 9 segundos de proceso. Los ojos, las cejas, la barba y la textura de la piel se veían claramente más nítidos, y seguía siendo reconocible como el mismo hombre. La piel quedó un poco más lisa de lo que quedaría en una foto real, y el estante de botellas detrás de él conservó sus bloques de compresión originales, porque el fondo no se toca.
El tamaño tampoco cambia. Face Enhancer restaura las caras a la resolución que envías; si además necesitas más píxeles, usa Image Upscaler (/models/image-upscaler-v1).
Las caras mejoran más cuando son reales, de tamaño razonable y bien visibles. Face Enhancer dispone de menos información facial si el origen es un dibujo o anime, o la cara es pequeña, está tapada o muy borrosa; eso limita la restauración de detalles faciales en una foto con Face Enhancer.
Flujo de la tarea
La llamada es asíncrona. Crea la tarea, consúltala hasta que llegue a un estado final y descarga la imagen desde el almacenamiento de la plataforma. Se devuelve una imagen por solicitud, cobrada a un precio fijo por imagen, y las solicitudes fallidas no se cobran.
Consejos
- Parte de una foto en la que las caras sean bastante grandes y bien visibles. Una cara de apenas unas decenas de píxeles tiene muy poco que reconstruir.
- Se restauran hasta tres caras, empezando por la más grande. Las demás se dejan como estaban.
- Usa
pngsi el resultado se va a editar o a comprimir otra vez: evita otra compresión con pérdida, pero el archivo es más grande. El formato no cambia el precio. - Compara el resultado con tu original a tamaño completo, sobre todo alrededor de los ojos y la piel. En nuestra prueba quedó algo más liso que una foto real, así que conserva el archivo original.
- ¿Necesitas más píxeles además de caras más limpias? Pasa la foto por Image Upscaler (
/models/image-upscaler-v1).
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": "spicyapi/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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.
