Nowe oświetlenieO modelu Relight
Opisz nowe światło i dostań to samo zdjęcie inaczej oświetlone.
Wywołujesz go nazwą modelu popnow/relight-v1/edit w POST /jobs/createTask, od 30 kredytów za obraz (0,03 USD).
Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
aspect_ratio | Nie | Kształt kadru: szeroki, kwadratowy albo pionowy. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Tak | Obraz, od którego zaczynasz. |
output_format | Nie | Format pliku wyniku. jpeg · png · webp · Domyślnie: jpeg |
prompt | Tak | 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 | Nie | Ta sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647 |
Ceny
Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,001 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.
| Opcja | Kredyty za obraz | ≈ USD |
|---|---|---|
| Standard | 30 | 0,03 USD |
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Relight w trzech krokach
- Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model popnow/relight-v1/edit i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 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"Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.
Pytania o API Relight
Ile kosztuje API Relight?
Relight kosztuje 30 kredytów (0,03 USD) za obraz. Kredyty są te same co na stronie (1 kredyt = 0,001 USD), a nieudane zadania są zwracane.
Jaka jest nazwa modelu Relight w API?
Wpisz popnow/relight-v1/edit do zadania Nowe oświetlenie w polu model żądania POST /jobs/createTask.
Jak opisać światło?
Nazwij źródło, kierunek, barwę i twardość: „warm golden sunset light coming through a window on the left, hard light with window-frame shadows” albo „a single hard spotlight from directly above in a dark studio”.
Czy osoba albo poza się zmienią?
Nie. W naszych testach twarze, stroje, pozy i kadr zostały; zmieniły się tylko światło, gradacja barw i cienie.
Czy można zmienić dzień na noc?
Tak, w rozsądnych granicach. Zdjęcie z solniska w południe zamieniło się w niebieską godzinę ze świecącymi reflektorami ciężarówki, a mglisty brzeg o świcie w złoty zachód słońca.
Co daje LoRA Relight?
Przy tym samym zdjęciu, prompcie i seedzie LoRA dała twardsze, bardziej kierunkowe światło i wzory szyb na ścianie, tam gdzie bazowy model zrobił łagodniejszą zmianę.
Jakie limity ma API Relight?
Proporcje obrazu: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Długość promptu (znaki): 1,000; Największy przesyłany plik: 10 MB. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Relight bez pisania kodu?
Tak. Playground uruchamia Relight na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.