Wprowadzenie
Nano Banana 2 Tekst na obraz to Gemini 3.1 Flash Image od Google, wydany 26 lutego 2026 roku, który generuje obrazy z pisemnego promptu. Google opisuje go jako jakość obrazu na poziomie Pro przy szybkości Flash. Generuje na czterech poziomach rozmiaru od 0.5k do 4k w czternastu proporcjach do 8:1 i przed rysowaniem może przeszukać sieć oraz obrazy referencyjne, w cenie zaczynającej się wyraźnie poniżej cen Google.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| pisemny brief | Nano Banana 2 Tekst na obraz |
| obraz do zmiany | Nano Banana 2 Edycja obrazu |
Najważniejsze funkcje
Trasa ekonomiczna i Official fallback
Żądania zaczynają się na trasie ekonomicznej, w cenie wyraźnie poniżej cennika Google. Przy włączonej opcji Official fallback (domyślnie włączona) żądanie, którego ta trasa nie zrealizuje, jest wykonywane ponownie na oficjalnej trasie po cenie oficjalnej. W obu przypadkach model to Gemini 3.1 Flash Image od Google, z poziomami rozmiaru, które Google publikuje dla Nano Banana 2.
Cztery poziomy, czternaście proporcji
Od szkiców 512 px po finały 4096 px i od wież 1:8 po banery 8:1. Proporcje nigdy nie zmieniają ceny, tylko poziom rozmiaru. W 2k nasz baner 4:1 wrócił o szerokości 4128 pikseli.
Wyszukiwanie przed rysowaniem
Wyszukiwanie w sieci pobiera aktualne fakty, takie jak daty, pogoda i zabytki; wyszukiwanie obrazów pobiera zdjęcia referencyjne prawdziwych miejsc i produktów. Oba to opcjonalne przełączniki na żądanie.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Do 5000 znaków. Opisz obiekt, otoczenie, światło i obiektyw pełnymi zdaniami; słowa w cudzysłowie są rysowane jako tekst na obrazie. od 1 znaków · do 5000 znaków |
aspect_ratio | Nie | Jedna z czternastu proporcji, w tym skrajnych banerów 4:1, 1:4, 8:1 i 1:8; domyślnie 16:9. Proporcje nie zmieniają ceny. |
resolution | Nie | 0.5k, 1k (domyślnie), 2k lub 4k. Kwadratowy obraz ma bok 512, 1024, 2048 lub 4096 pikseli; każdy poziom ma własną cenę. |
enable_web_search | Nie | Domyślnie wyłączone. Po włączeniu model przed rysowaniem sprawdza aktualne fakty, takie jak pogoda, daty czy zabytki. Domyślnie: |
enable_image_search | Nie | Domyślnie wyłączone. Po włączeniu model przed rysowaniem szuka w sieci obrazów referencyjnych, co pomaga przy prawdziwych miejscach i produktach. Domyślnie: |
official_fallback | Nie | Domyślnie włączone. Każde żądanie najpierw wykonuje się ścieżką ekonomiczną. Domyślnie: |
Cennik
Rozliczenie za obraz według poziomu rozmiaru; proporcje nie zmieniają ceny. Każde żądanie zaczyna się na trasie ekonomicznej, po cenie ekonomicznej. Przy włączonej opcji Official fallback (domyślnie włączona) żądanie, które trasa ekonomiczna odrzuci albo którego nie zrealizuje, jest wykonywane ponownie na oficjalnej trasie po cenie oficjalnej, dlatego wycena pokazuje cenę startową i maksymalną kwotę; wyłącz ją, jeśli chcesz płacić tylko cenę ekonomiczną. Żądania w 0.5k lub z wyszukiwaniem w sieci albo wyszukiwaniem obrazów idą oficjalną trasą, a każde wyszukiwanie dolicza opłatę. Na oficjalnej trasie odmowa, która wraca jako krótka odpowiedź tekstowa zamiast obrazu, liczy się jako ukończone generowanie i jest rozliczana po cenie oficjalnej; pozostałe odmowy nie są rozliczane.
| Specyfikacja | Cena |
|---|---|
| $0.036 / obraz |
| $0.0384 / obraz (Z opcją Official fallback: do $0.0536) |
| $0.0602 / obraz (Z opcją Official fallback: do $0.0808) |
| $0.0902 / obraz (Z opcją Official fallback: do $0.1208) |
Zastosowania
Nagłówki stron i billboardy
Bardzo szerokie banery 4:1 i 8:1 oddane jako jedno ciągłe zdjęcie, bez późniejszego sklejania czy rozciągania.
Szybkie szkice mody i lifestyle’u
Wiele kierunków na godzinę w 0.5k i 1k, a najlepszy ponownie w 2k do oddania.
Prawdziwe miejsca i produkty
Z włączonym wyszukiwaniem obrazów sceny osadzone przed prawdziwym zabytkiem lub z prawdziwym produktem mogą oprzeć się na zdjęciach referencyjnych z sieci.
Wysokie formaty na telefon
Wysokie obrazy 1:4 i 1:8 do relacji i banerów bocznych, generowane jako jeden ciągły obraz.
Wskazówki
Daj treść obu krawędziom w szerokich formatach
Przy 4:1 i 8:1 opisz, co wypełnia lewą i prawą krawędź: długą plażę, panoramę miasta, rząd witryn. Inaczej końce stają się pustym niebem.
Wyszukiwanie do faktów, nie do stylu
Wyszukiwanie w sieci pomaga, gdy obraz zależy od czegoś aktualnego lub prawdziwego. Nie poprawia stylu ani kompozycji, więc w innych przypadkach zostaw je wyłączone.
Mały szkic, duże oddanie
Używaj tego samego promptu od 0.5k do 4k; kompozycja pozostaje zbliżona, więc decyzje podjęte na szkicu nadal obowiązują.
Wybierz 2k do oddania
W 2k kwadratowy obraz ma bok 2048 pikseli, co wystarcza na większość ekranów i stron; 4k zostaw do druku i mocnych kadrowań.
Szybki start z API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"enable_web_search": false,
"enable_image_search": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
