Neu beleuchtenÜber Relight
Neues Licht beschreiben, dasselbe Foto neu beleuchtet erhalten.
Du rufst es mit dem Modellnamen popnow/relight-v1/edit über POST /jobs/createTask auf, ab 30 Credits pro Bild (0,03 $).
Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
aspect_ratio | Nein | Die Form des Bildes: breit, quadratisch oder hoch. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Ja | Das Bild, von dem aus es losgeht. |
output_format | Nein | Dateiformat des Ergebnisses. jpeg · png · webp · Standardwert: jpeg |
prompt | Ja | The new light: source, direction, colour and hardness, e.g. "Relight the image with warm golden sunset light from a window on the left." |
seed | Nein | Dieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647 |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,001 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Bild | ≈ USD |
|---|---|---|
| Standard | 30 | 0,03 $ |
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Relight API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model popnow/relight-v1/edit und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/relight-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Relight API
Was kostet die Relight API?
Relight kostet 30 Credits (0,03 $) pro Bild. Die Credits sind dieselben wie auf der Website (1 Credit = 0,001 $), und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Relight in der API?
Trag popnow/relight-v1/edit für Neu beleuchten im Feld model von POST /jobs/createTask ein.
Wie beschreibe ich das Licht?
Benennen Sie Quelle, Richtung, Farbe und Härte: „warm golden sunset light coming through a window on the left, hard light with window-frame shadows“ oder „a single hard spotlight from directly above in a dark studio“.
Ändern sich Person oder Pose?
Nein. In unseren Läufen blieben Gesichter, Outfits, Posen und Bildausschnitt erhalten. Nur Licht, Farbgebung und Schatten änderten sich.
Kann es von Tag auf Nacht wechseln?
Ja, in vernünftigem Rahmen. Ein Salzebenen-Foto am Mittag wurde zur Blauen Stunde mit leuchtenden Scheinwerfern des Lkw, und ein nebliges Morgenufer wurde zu einem goldenen Sonnenuntergang.
Was bringt das Relight-LoRA?
Bei demselben Foto, Prompt und Seed erzeugte das LoRA hartes, stärker gerichtetes Licht und Fensterscheiben-Muster an der Wand, während das Basismodell eine weichere Veränderung machte.
Welche Limits hat die Relight API?
Seitenverhältnisse: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Prompt-Länge (Zeichen): 1,000; Größter Upload: 10 MB. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Relight testen, ohne Code zu schreiben?
Ja. Der Playground führt Relight mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.