Introduction
Relight modifie la lumière d’une photo. Décrivez la lumière voulue et recevez les mêmes personnes et la même scène, éclairées de cette façon : lumière de fenêtre au coucher du soleil, heure bleue, spot dur venu du haut ou liseré doré par l’arrière. Rien d’autre dans le cadre n’est censé changer.
Fonctionnalités et points forts
La lumière en une phrase
Écrivez la source, la direction, la couleur et la dureté. L’outil fait tourner Qwen-Image-Edit-2511 avec le LoRA Relight de dx8152, entraîné sur des paires de rééclairage avant et après, de sorte qu’il déplace la lumière et les ombres au lieu de repeindre l’image.
Les personnes et le cadrage restent
Les visages, les vêtements, la pose et la composition sont restés identiques dans chaque test ; seuls la lumière, les ombres et l’étalonnage ont bougé, ce qui permet d’utiliser une photo rééclairée à côté de l’original dans une série.
Des changements d’ambiance plus marqués
Un studio de danse blanc est devenu une pièce sombre avec un seul spot, et une rive brumeuse à l’aube est devenue un coucher de soleil doré avec un contre-jour.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | La photo à rééclairer. Un lien HTTPS public ou un fichier envoyé, en JPEG, PNG ou WebP, jusqu’à 10 Mo. 1 caractères minimum |
prompt | Oui | La nouvelle lumière, en commençant par « Relight the image with ... 1 caractères minimum · 1000 caractères maximum |
aspect_ratio | Non | Facultatif. Laissez vide et le résultat garde la forme de votre photo à environ un mégapixel. |
output_format | Non | JPEG par défaut, PNG ou WebP si vous en avez besoin. Ne change pas le prix. |
seed | Non | Réutilisez le même nombre pour comparer deux essais sur la même photo. Tout nombre entier de 0 à 2147483647 ; laissez vide pour une seed aléatoire. |
Tarification
$0.03 / image
Facturé par image produite, à un prix fixe. Le ratio d’image et le format de sortie ne changent pas le prix, et les requêtes en échec ne sont pas facturées.
Cas d’utilisation
Sauver les photos plates
Ajoutez une direction et une ambiance aux portraits et aux photos de produit éclairés uniformément, sortis d’une softbox ou d’une journée couverte et sans vie.
Moment de la journée
Faites passer une photo de lieu à l’heure bleue ou à l’heure dorée sans y retourner, par exemple une étendue de sel à l’heure bleue avec les feux du camion allumés.
Une seule ambiance pour une série
Ramenez des photos prises sous des lumières différentes à une même ambiance cohérente pour une campagne, un lookbook ou un carrousel.
Guide de prompt et conseils pratiques
Commencez par « Relight the image with »
Nommez ensuite la source de lumière et d’où elle vient. Le précis bat le vague : « a single hard spotlight from directly above » marche mieux que « dramatic ».
Supprimez d’abord les anciennes ombres
Si la photo a déjà des ombres dures, passez d’abord par Shadow Remover puis rééclairez le résultat propre.
Attendez-vous à des accessoires pour une lumière motivée
Demander une lumière de fenêtre peut ajouter une fenêtre à la scène. Si vous ne voulez pas d’objets nouveaux, décrivez seulement la lumière (« warm light from the left »).
Changez une chose à la fois
Demandez un seul dispositif d’éclairage à la fois. Quand un résultat est proche, gardez la seed et ne modifiez que la couleur ou la direction dans le prompt, pour comparer les deux versions côte à côte.
Démarrage rapide de l’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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
