Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
image_url | Tak | Obraz, od którego zaczynasz. |
Ceny
Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). 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 | 0,72 | 0,0072 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 1 kredyt za obraz (0,01 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Background Remover 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/background-remover-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/background-remover-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'
# 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 Background Remover
Ile kosztuje API Background Remover?
Background Remover kosztuje 1 kredyt (0,01 USD) za obraz. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.
Jaka jest nazwa modelu Background Remover w API?
Wpisz popnow/background-remover-v1/edit do zadania Usuń tło w polu model żądania POST /jobs/createTask.
Czy muszę opisywać obiekt?
Nie. Endpoint przyjmuje jedno pole, image_url, i sam wybiera pierwszy plan. Jeśli na zdjęciu jest kilku kandydatów, najpierw przytnij je do tego, którego chcesz.
Co dostaję w odpowiedzi?
Jeden PNG z przezroczystym tłem, o tej samej szerokości i wysokości co wysłany obraz, więc możesz od razu nałożyć go na oryginał.
Czy może wstawić nowe tło?
Nie w tym samym wywołaniu: tylko usuwa. Połóż PNG na własnym kolorze lub zdjęciu albo zbuduj nową scenę w Image Expander i nałóż na nią wycięcie.
Jakie zdjęcia sprawdzają się najlepiej?
Takie, na których jeden wyraźny obiekt odcina się od otoczenia kolorem lub światłem. Krawędzie o niskim kontraście, poruszenie i obiekty ucięte przez kadr to miejsca, gdzie wycięcie się sypie.
Czy mogę wypróbować Background Remover bez pisania kodu?
Tak. Playground uruchamia Background Remover na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.