Wprowadzenie
Nano Banana 2 Edycja obrazu stosuje Gemini 3.1 Flash Image od Google do obrazów, które już masz. Przyjmuje od jednego do czternastu źródeł, zachowuje proporcje źródła albo zmienia je na jedną z czternastu, i generuje w 0.5k, 1k, 2k lub 4k.
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
Do czternastu referencji
Łącz osoby, stroje, otoczenia i produkty z maksymalnie czternastu obrazów, opisując w prompcie rolę każdego z nich. Trasa ekonomiczna przyjmuje do dziesięciu; przy większej liczbie edycja idzie oficjalną trasą, gdzie każde źródło dolicza niewielką stałą opłatę, więc przekazuj tylko te, których edycja potrzebuje.
Przekadrowanie podczas edycji
Proporcje auto zachowują kształt źródła; jedna z czternastu proporcji przekadrowuje wynik, jak w naszym przykładzie, gdzie baner 4:1 stał się nocną sceną 16:9.
Szybko w każdym rozmiarze
Te same poziomy co w trybie tekst na obraz, od szkiców 0.5k po finały 4k, z ceną według poziomu; na oficjalnej trasie dochodzi niewielka opłata za źródło.
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 |
image_urls | Tak | Od 1 do 14 obrazów źródłowych. Napisz w prompcie, co wnosi każdy z nich: osobę, otoczenie, produkt. od 1 elementów · do 14 elementów |
aspect_ratio | Nie | auto (domyślnie) zachowuje proporcje obrazu źródłowego; możesz też wybrać jedną z czternastu proporcji, w tym skrajnych banerów 4:1, 1:4, 8:1 i 1:8. 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żda edycja najpierw wykonuje się ścieżką ekonomiczną. Domyślnie: |
Cennik
Rozliczenie za obraz według poziomu rozmiaru. Każda edycja zaczyna się na trasie ekonomicznej, po cenie ekonomicznej, bez opłaty za obrazy źródłowe. Przy włączonej opcji Official fallback (domyślnie włączona) edycja, którą trasa ekonomiczna odrzuci albo której nie zrealizuje, a także edycja z ponad 10 obrazami źródłowymi idzie oficjalną trasą po cenie oficjalnej, która dolicza też niewielką stałą opłatę za każdy obraz źródłowy; wyłącz ją, jeśli chcesz płacić tylko cenę ekonomiczną. Edycje w 0.5k lub z wyszukiwaniem w sieci albo wyszukiwaniem obrazów idą oficjalną trasą, a każde wyszukiwanie dolicza opłatę. Wycena pokazuje cenę startową i maksymalną kwotę edycji. 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
Zmiana miejsca i pory dnia
Przenieś osobę w nowe miejsce albo zamień dzień w noc na potrzeby kampanii, zachowując twarz, strój i pozę.
Dopasowanie gotowych obrazów do innych formatów
Zamień szeroki baner w wersję 16:9 lub 9:16 z nową treścią przy krawędziach zamiast zwykłego kadrowania.
Kompozycje produktów
Ułóż kilka zdjęć produktów w jednej zaaranżowanej scenie, nazywając każdy produkt i jego miejsce.
Wskazówki
Wymień, co ma zostać
Po opisaniu zmiany nazwij twarz, włosy, strój i pozę do zachowania; model trzyma się wyraźnej listy.
Opisz nowy kadr przy przekadrowaniu
Gdy zmieniają się proporcje, napisz, co ma wypełnić dodatkową przestrzeń: więcej nieba, kolejny stolik, dalszą część ulicy.
Wyszukiwanie tylko przy prawdziwych referencjach
Włączaj wyszukiwanie obrazów tylko wtedy, gdy edycja zależy od prawdziwego miejsca lub produktu, który model musi zobaczyć.
Testuj edycje w 0.5k
Najpierw wypróbuj polecenie w 0.5k; jeśli edycja działa, uruchom to samo żądanie w 2k lub 4k.
Dopasuj poziom do źródła
Edycja nie doda szczegółów, których źródło nigdy nie miało; 2k zwykle wystarcza, chyba że samo źródło jest duże.
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/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
