Introduzione
Relight cambia la luce di una foto. Descrivi la luce che vuoi e ricevi le stesse persone e la stessa scena, illuminate in quel modo: luce di finestra al tramonto, ora blu, un faretto duro dall’alto o un contorno dorato da dietro. Nient’altro nell’inquadratura dovrebbe cambiare.
Caratteristiche principali
La luce da una frase
Scrivi sorgente, direzione, colore e durezza. Lo strumento esegue Qwen-Image-Edit-2509 con il Relight LoRA di dx8152, addestrato su coppie di relight prima e dopo, quindi sposta luce e ombre invece di ridipingere l’immagine.
Persone e inquadratura restano
Volti, abiti, posa e composizione sono rimasti invariati in ogni test; sono cambiati solo luce, ombre e correzione del colore, il che rende una foto ri-illuminata utilizzabile accanto all’originale in un set.
Cambi d’atmosfera più ampi
Uno studio di danza bianco è diventato una stanza buia con un solo faretto, e una riva all’alba nebbiosa è diventata un tramonto dorato con luce di controluce.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | La foto da ri-illuminare. Un link HTTPS pubblico o un caricamento, JPEG, PNG o WebP, fino a 10 MB. almeno 1 caratteri |
prompt | Sì | La nuova luce, che inizia con “Relight the image with ...”: sorgente, direzione, colore e durezza, per esempio “Relight the image with warm golden sunset light coming through a… almeno 1 caratteri · al massimo 1000 caratteri |
aspect_ratio | No | Facoltativo. Lascialo vuoto e il risultato mantiene la forma della foto a circa un megapixel. |
output_format | No | JPEG per impostazione predefinita, PNG o WebP se ti servono. Non cambia il prezzo. |
seed | No | Usa di nuovo lo stesso numero per confrontare due esecuzioni sulla stessa foto. Qualsiasi intero da 0 a 2147483647; lascialo vuoto per un seed casuale. |
Prezzi
$0.03 / immagine
Addebitato per immagine di output a un unico prezzo fisso. Proporzioni e formato di output non cambiano il costo, e le richieste fallite non vengono addebitate.
Casi d’uso
Salvare foto piatte
Aggiungi direzione e atmosfera a ritratti e foto di prodotto illuminati in modo uniforme da un softbox o da una giornata nuvolosa e venuti senza vita.
Ora del giorno
Sposta una foto di location all’ora blu o all’ora dorata senza tornare sul posto, per esempio una salina all’ora blu con le luci del camion accese.
Un unico look per un set
Porta foto scattate con luci diverse a un look coerente per una campagna, un lookbook o un carosello.
Consigli avanzati
Inizia con “Relight the image with”
Poi indica la sorgente della luce e da dove arriva. Il preciso batte il vago: “a single hard spotlight from directly above” funziona meglio di “dramatic”.
Rimuovi prima le ombre vecchie
Se la foto ha già ombre dure, usa prima Shadow Remover e ri-illumina il risultato pulito.
Aspettati oggetti per una luce motivata
Chiedere una luce da finestra può aggiungere una finestra alla scena. Se non vuoi oggetti nuovi, descrivi solo la luce (“warm light from the left”).
Cambia una cosa per esecuzione
Chiedi un solo setup di luce alla volta. Quando un risultato è vicino, mantieni il seed e modifica solo il colore o la direzione nel prompt, così puoi confrontare le due versioni affiancate.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
