Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
aspect_ratio | Nie | Kształt kadru: szeroki, kwadratowy albo pionowy. auto · 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 · Domyślnie: auto |
enable_image_search | Nie | Najpierw szuka prawdziwych zdjęć miejsca lub produktu. Domyślnie: false |
enable_web_search | Nie | Najpierw sprawdza w sieci daty, miejsca i bieżące fakty. Domyślnie: false |
image_urls | Tak | Zdjęcia do edycji lub połączenia. W prompcie napisz, co wnosi każde z nich. |
output_format | Nie | Format pliku wyniku. png · jpeg · Domyślnie: png |
prompt | Tak | Say what to change and what must stay the same. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 1k · 2k · 4k · Domyślnie: 1k |
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 |
|---|---|---|
| resolution 1K | 7,2 | 0,072 USD |
| resolution 2K | 10,8 | 0,11 USD |
| resolution 4K | 24,3 | 0,24 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 8 kredytów za obraz (0,08 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Nano Banana 2.1 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 google/nano-banana-2.1/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": "google/nano-banana-2.1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "1k",
"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 Nano Banana 2.1
Ile kosztuje API Nano Banana 2.1?
Nano Banana 2.1 kosztuje od 8 kredytów (0,08 USD) za obraz – najtańsze zadanie to „Edytuj obraz”. Ceny według opcji: 1K 7,2 kredytu za obraz, 2K 10,8 kredytu za obraz, 4K 24,3 kredytu 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 Nano Banana 2.1 w API?
Wpisz google/nano-banana-2.1/text-to-image do zadania Utwórz obraz; google/nano-banana-2.1/edit do zadania Edytuj obraz w polu model żądania POST /jobs/createTask.
Czy to Nano Banana 2.1 od Google?
Tak. Żądania trafiają do modelu, który Google wydał 6 października 2026 jako Nano Banana 2.1, aktualizację Nano Banana 2 (Gemini 3.1 Flash Image). Wyniki w 1K, 2K i 4K zgadzają się z rozmiarami, które Google podaje dla tego modelu.
Nano Banana 2.1 czy Nano Banana 2?
Wersja 2.1 jest nowsza: Google poprawił jakość obrazu, zgodność z promptem, spójność postaci i tekst oraz — jak twierdzi — usunął szwy na szerokich banerach w 2K i 4K. Nano Banana 2 zachowuje poziom szkicu 0.5K, którego w 2.1 nie ma. Oba oferują wyszukiwanie w sieci i obrazów oraz do czternastu referencji. Google uznał Nano Banana 2 za przestarzały (bez ogłoszonej daty wyłączenia) i zaleca przejście na 2.1.
Jak radzi sobie z tekstem?
Każda linia, którą ujęliśmy w cudzysłów, wyszła napisana tak, jak podano: tytuł magazynu z dwoma hasłami okładkowymi, tytuł filmu z linijką o premierze, neon motelu i tytuł albumu zaprojektowany na pustej okładce w edycji. Drobny druk, którego nie wpisaliśmy, na przykład drobne linijki pod tytułem plakatu czy kod kreskowy, wyszedł jako wypełniacz.
Jak duże są obrazy?
Przy 1:1 poziomy mają bok 1024, 2048 i 4096 pikseli. Inne proporcje zachowują zbliżoną liczbę pikseli: w naszych testach 3:4 w 1k wróciło jako 896 × 1200, 16:9 w 2k jako 2752 × 1536, a baner 8:1 w 2k jako 5856 × 704.
Jakie limity ma API Nano Banana 2.1?
Rozdzielczości: 1K · 2K · 4K; Proporcje obrazu: auto · 1:1 · 3:2 · 2:3 · 3:4 · 4:3 +9; Obrazy referencyjne: 14; Długość promptu (znaki): 5,000; Największy przesyłany plik: 10 MB. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Nano Banana 2.1 bez pisania kodu?
Tak. Playground uruchamia Nano Banana 2.1 na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Nano Banana
Nano Banana Pro najpierw planuje układ, a dopiero potem rysuje, więc staranniej radzi sobie z gęstym tekstem, diagramami i wieloczęściowymi projektami. Nano Banana 2.1 jest nowszy, szybszy i kosztuje za obraz mniej niż połowę, a do tego dodaje banery 8:1 oraz wyszukiwanie w sieci i po obrazach.

