Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
image_url | Tak | Obraz, od którego zaczynasz. |
mask_url | Nie | Zamaluj obszar, który ma się zmienić. |
output_format | Nie | Format pliku wyniku. png · jpeg · webp · Domyślnie: png |
prompt | Nie | What to remove, in a few plain words with a position when there is more than one, e.g. "the wooden bench on the left". |
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 | 4,5 | 0,045 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 5 kredytów za obraz (0,05 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Object Eraser 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/object-eraser-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/object-eraser-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": "png"
}
}'
# 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 Object Eraser
Ile kosztuje API Object Eraser?
Object Eraser kosztuje 5 kredytów (0,05 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 Object Eraser w API?
Wpisz popnow/object-eraser-v1/edit do zadania Gumka AI w polu model żądania POST /jobs/createTask.
Czy potrzebuję maski?
Nie zawsze. Przy wyraźnym przedmiocie z wolną przestrzenią wokół wystarczy krótki opis: w naszych testach drewniana chochla zniknęła na podstawie samego tekstu. Cienkie przedmioty i rzeczy przy krawędzi kadru są za to często pomijane, a zdjęcie wraca bez zmian: wysoki stojak przy krawędzi kadru został na miejscu przy dwóch różnie sformułowanych opisach i zniknął za pierwszym razem, gdy dodaliśmy maskę. Wyślij mask_url, gdy opis nie działa albo gdy chcesz usunąć tylko jeden z dwóch podobnych przedmiotów.
Co jeśli mój opis do niczego nie pasuje?
Dostajesz zdjęcie bez zmian, a żądanie liczy się jako ukończone. Nazwij coś, co naprawdę jest na obrazie, i dodaj położenie, gdy takich rzeczy jest kilka.
Jak powinna wyglądać maska?
Tego samego rozmiaru co zdjęcie, biała na tym, co ma zniknąć, i czarna wszędzie indziej. Maluj trochę poza krawędź przedmiotu, żeby zniknęły też kontur i cień.
Czy można wstawić coś nowego w puste miejsce?
Nie. Narzędzie usuwa i wypełnia miejsce pasującym otoczeniem.
Jakie limity ma API Object Eraser?
Długość promptu (znaki): 1,000. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Object Eraser bez pisania kodu?
Tak. Playground uruchamia Object Eraser na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.