Einführung
Relight verändert das Licht in einem Foto. Beschreiben Sie das gewünschte Licht und erhalten Sie dieselben Personen und dieselbe Szene so ausgeleuchtet zurück: Fensterlicht bei Sonnenuntergang, Blaue Stunde, ein hartes Spotlight von oben oder ein goldenes Konturlicht von hinten. Am übrigen Bildinhalt soll sich nichts ändern.
Wichtige Funktionen und Highlights
Licht aus einem Satz
Beschreiben Sie Quelle, Richtung, Farbe und Härte. Das Tool läuft mit Qwen-Image-Edit-2511 und dem Relight-LoRA von dx8152, das auf Vorher-nachher-Paaren trainiert wurde. So verschiebt es Licht und Schatten, statt das Bild neu zu malen.
Personen und Bildausschnitt bleiben
Gesichter, Kleidung, Pose und Komposition blieben in allen Tests unverändert. Nur Licht, Schatten und Farbgebung haben sich verschoben. Dadurch lässt sich ein neu beleuchtetes Foto neben dem Original in einer Serie verwenden.
Größere Stimmungswechsel
Ein weißes Tanzstudio wurde zu einem dunklen Raum mit einem einzelnen Spotlight, und ein nebliges Morgenufer wurde zu einem goldenen Sonnenuntergang mit Konturlicht.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Das Foto, das neu beleuchtet werden soll. Öffentlicher HTTPS-Link oder Upload, JPEG, PNG oder WebP, bis 10 MB. mindestens 1 Zeichen |
prompt | Ja | Das neue Licht, beginnend mit „Relight the image with ...“: seine Quelle, Richtung, Farbe und Härte, zum Beispiel „Relight the image with warm golden sunset light coming through… mindestens 1 Zeichen · höchstens 1000 Zeichen |
aspect_ratio | Nein | Optional. Leer lassen, dann behält das Ergebnis die Form Ihres Fotos bei etwa einem Megapixel. |
output_format | Nein | Standardmäßig JPEG, PNG oder WebP, falls Sie diese benötigen. Ändert den Preis nicht. |
seed | Nein | Dieselbe Zahl erneut verwenden, um zwei Läufe mit demselben Foto zu vergleichen. Jede ganze Zahl von 0 bis 2147483647; leer lassen für einen zufälligen Seed. |
Preis
$0.03 / Bild
Abgerechnet wird pro ausgegebenem Bild zu einem festen Preis. Seitenverhältnis und Ausgabeformat ändern den Preis nicht, und fehlgeschlagene Anfragen werden nicht berechnet.
Anwendungsfälle
Flache Fotos retten
Geben Sie gleichmäßig ausgeleuchteten Porträts und Produktfotos, die aus einer Softbox oder einem bedeckten Tag leblos wirken, Richtung und Stimmung.
Tageszeit
Verlegen Sie ein Ortsfoto in die Blaue Stunde oder die goldene Stunde, ohne an den Ort zurückzukehren, etwa eine Salzebene in der Blauen Stunde mit eingeschalteten Lkw-Scheinwerfern.
Ein Look für eine Serie
Bringen Sie Fotos, die bei unterschiedlichem Licht entstanden sind, für eine Kampagne, ein Lookbook oder ein Karussell auf einen einheitlichen Look.
Prompt-Leitfaden und Praxistipps
Mit „Relight the image with“ beginnen
Nennen Sie danach die Lichtquelle und woher sie kommt. Konkret schlägt vage: „a single hard spotlight from directly above“ funktioniert besser als „dramatic“.
Alte Schatten zuerst entfernen
Hat das Foto bereits harte Schatten, führen Sie zuerst Shadow Remover aus und beleuchten Sie dann das saubere Ergebnis neu.
Bei motiviertem Licht mit neuen Objekten rechnen
Fragen Sie nach Fensterlicht, kann dadurch ein Fenster in die Szene kommen. Wenn Sie keine neuen Objekte möchten, beschreiben Sie nur das Licht („warm light from the left“).
Pro Lauf nur eine Änderung
Fordern Sie jeweils nur ein Lichtsetup an. Wenn ein Ergebnis nahe am Ziel ist, behalten Sie den Seed und ändern nur Farbe oder Richtung im Prompt, damit Sie beide Versionen nebeneinander vergleichen können.
API-Schnellstart
# 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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
