Introdução
O Relight muda a luz de uma foto. Descreva a luz que você quer e receba de volta as mesmas pessoas e a mesma cena, iluminadas dessa forma: luz de janela no pôr do sol, hora azul, um spot duro de teto ou uma borda dourada por trás. Nada mais no quadro deve mudar.
Recursos e destaques
Luz a partir de uma frase
Escreva a fonte, a direção, a cor e a dureza. A ferramenta roda o Qwen-Image-Edit-2509 com o Relight LoRA de dx8152, treinado com pares de reiluminação antes e depois, então move a luz e a sombra em vez de repintar a imagem.
Pessoas e enquadramento permanecem
Rostos, roupas, pose e composição não mudaram em nenhum teste; só a luz, as sombras e a gradação de cor se moveram, o que mantém a foto reiluminada utilizável ao lado do original em um conjunto.
Mudanças de clima mais fortes
Um estúdio de dança branco virou um quarto escuro com um único spot, e uma praia de amanhecer nebuloso virou um pôr do sol dourado com contraluz.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A foto a ser reiluminada. Um link HTTPS público ou um upload, em JPEG, PNG ou WebP, de até 10 MB. pelo menos 1 caracteres |
prompt | Sim | A nova luz, começando com "Relight the image with ...": a fonte, a direção, a cor e a dureza, por exemplo "Relight the image with warm golden sunset light coming through a windo… pelo menos 1 caracteres · no máximo 1000 caracteres |
aspect_ratio | Não | Opcional. Deixe vazio e o resultado mantém o formato da sua foto em cerca de um megapixel. |
output_format | Não | JPEG por padrão; PNG ou WebP se precisar. Não altera o preço. |
seed | Não | Use o mesmo número outra vez para comparar duas execuções na mesma foto. Qualquer inteiro de 0 a 2147483647; deixe vazio para uma seed aleatória. |
Preços
$0.03 / imagem
Cobrado por imagem gerada, a um preço fixo. A proporção e o formato de saída não alteram o valor, e solicitações que falham não são cobradas.
Casos de uso
Salve fotos chapadas
Acrescente direção e clima a retratos e fotos de produto com luz uniforme que saíram de uma softbox ou de um dia nublado, com aparência sem vida.
Hora do dia
Leve uma foto de local para hora azul ou hora dourada sem voltar ao local, por exemplo um salar em hora azul com as luzes da picape acesas.
Um visual para o conjunto
Leve fotos feitas com luz diferente a um mesmo visual para uma campanha, um lookbook ou um carrossel.
Guia de prompt e dicas práticas
Comece com "Relight the image with"
Depois, nomeie a fonte de luz e de onde ela vem. Específico vence vago: "a single hard spotlight from directly above" funciona melhor do que "dramatic".
Remova as sombras antigas primeiro
Se a foto já tem sombras duras, rode antes o Shadow Remover e reilumine o resultado limpo.
Espere adereços para luz motivada
Pedir luz de janela pode acrescentar uma janela à cena. Se você não quer objetos novos, descreva só a luz ("warm light from the left").
Mude uma coisa por execução
Peça um esquema de luz por vez. Quando um resultado estiver perto do desejado, mantenha a seed e ajuste só a cor ou a direção no prompt, para comparar as duas versões lado a lado.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
