Introducción
Relight cambia la luz de una foto. Describe la luz que quieres y recibe de vuelta a las mismas personas y a la misma escena, iluminadas de esa manera: luz de ventana al atardecer, hora azul, un foco cenital duro o un contorno dorado desde atrás. No se pretende cambiar nada más del encuadre.
Funciones y aspectos destacados
Luz a partir de una frase
Escribe la fuente, la dirección, el color y la dureza. La herramienta usa Qwen-Image-Edit-2509 con el LoRA Relight de dx8152, entrenado con pares de reiluminación de antes y después, así que mueve la luz y la sombra en lugar de volver a pintar la imagen.
Las personas y el encuadre se mantienen
Los rostros, la ropa, la pose y la composición no cambiaron en ninguna prueba; solo se movieron la luz, las sombras y la gradación de color, lo que permite usar la foto reiluminada junto al original dentro de un set.
Cambios de ambiente más fuertes
Un estudio de danza blanco se convirtió en una habitación oscura con un solo foco, y una orilla con niebla al amanecer se convirtió en un atardecer dorado con contraluz.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto a reiluminar. Un enlace HTTPS público o una subida, en JPEG, PNG o WebP, de hasta 10 MB. mínimo 1 caracteres |
prompt | Sí | La nueva luz, empezando por "Relight the image with ...": su fuente, dirección, color y dureza, por ejemplo "Relight the image with warm golden sunset light coming through a win… mínimo 1 caracteres · máximo 1000 caracteres |
aspect_ratio | No | Opcional. Déjalo vacío y el resultado conserva la forma de tu foto a alrededor de un megapíxel. |
output_format | No | JPEG por defecto; PNG o WebP si los necesitas. No cambia el precio. |
seed | No | Usa el mismo número de nuevo para comparar dos ejecuciones sobre la misma foto. Cualquier entero de 0 a 2147483647; déjalo vacío para una seed aleatoria. |
Precios
$0.03 / imagen
Se cobra por imagen de salida a un precio fijo. La relación de aspecto y el formato de salida no cambian el precio, y las solicitudes fallidas no se cobran.
Casos de uso
Rescatar fotos planas
Añade dirección y ambiente a retratos y fotos de producto con luz uniforme que salieron sin vida de un softbox o de un día nublado.
Hora del día
Lleva una foto de locación a hora azul o a hora dorada sin volver al lugar, por ejemplo un salar en hora azul con las luces de la camioneta encendidas.
Un solo look para un set
Lleva fotos tomadas con luces distintas a un look consistente para una campaña, un lookbook o un carrusel.
Guía de prompts y consejos prácticos
Empieza con "Relight the image with"
Después nombra la fuente de luz y de dónde viene. Lo específico gana a lo vago: "a single hard spotlight from directly above" funciona mejor que "dramatic".
Quita primero las sombras viejas
Si la foto ya tiene sombras duras, ejecuta Shadow Remover primero y reilumina el resultado limpio.
Espera accesorios para una luz motivada
Pedir luz de ventana puede agregar una ventana a la escena. Si no quieres objetos nuevos, describe solo la luz ("warm light from the left").
Cambia una cosa por ejecución
Pide una sola configuración de luz a la vez. Cuando un resultado está cerca, mantén la seed y ajusta solo el color o la dirección en el prompt, para comparar las dos versiones lado a lado.
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/relight-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
