Rozszerz obrazO modelu Image Expander
Poszerz zdjęcie do nowych proporcji: wokół oryginału dorysowywana jest nowa sceneria zamiast przycinania czy rozciągania.
Wywołujesz go nazwą modelu popnow/image-expander-v1/edit w POST /jobs/createTask, od 4 kredyty za obraz (0,04 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.
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 · Domyślnie: 1:1 |
image_url | Tak | Obraz, od którego zaczynasz. |
output_format | Nie | Format pliku wyniku. png · jpeg · webp · Domyślnie: png |
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 | 3,6 | 0,036 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 4 kredyty za obraz (0,04 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Image Expander 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/image-expander-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/image-expander-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"aspect_ratio": "1:1",
"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 Image Expander
Ile kosztuje API Image Expander?
Image Expander kosztuje 4 kredyty (0,04 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 Image Expander w API?
Wpisz popnow/image-expander-v1/edit do zadania Rozszerz obraz w polu model żądania POST /jobs/createTask.
Czy mogę wskazać, co pojawi się w nowym obszarze?
Nie. Nie ma pola promptu; poszerzenie kontynuuje to, co już jest na zdjęciu.
Jaki rozmiar ma wynik?
Dłuższy bok ma zawsze 1536 pikseli, a krótszy wynika z wybranej proporcji: 1536 × 864 dla 16:9, 864 × 1536 dla 9:16, 1536 × 1536 dla 1:1.
Jaką proporcję wybrać?
Tę, której używa miejsce publikacji: 16:9 na okładki wideo i nagłówki, 9:16 na relacje i rolki, 1:1 na feed i kafle marketplace’ów, 3:2 lub 2:3 na układy w stylu druku.
Jakie limity ma API Image Expander?
Proporcje obrazu: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Image Expander bez pisania kodu?
Tak. Playground uruchamia Image Expander na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.