Wprowadzenie
Nano Banana Pro Edycja obrazu stosuje Gemini 3 Pro Image od Google do obrazów, które już masz. Przyjmuje od jednego do czternastu źródeł, planuje edycję przed renderowaniem i zwraca 1k, 2k lub 4k w proporcjach źródła albo w jednej z dziesięciu proporcji.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| pisemny brief | Nano Banana Pro Tekst na obraz |
| obraz do zmiany | Nano Banana Pro Edycja obrazu |
Najważniejsze funkcje
Dokładne edycje z jedną zmianą
Nowe światło, nowe tło lub dodany tekst, podczas gdy osoby i reszta obrazu zostają bez zmian, jak w naszych przykładach ze świecami i okładką. Model planuje edycję przed renderowaniem, co utrzymuje stabilność niezmienianych części obrazu.
Tekst na zdjęciach
Tytuły, numery i podpisy są nakładane na obraz w pisowni, którą cytujesz, i w miejscu, które wskazujesz.
Do czternastu referencji
Łącz osoby, produkty i otoczenia z wielu źródeł, opisując w prompcie rolę każdego z nich, w jednym żądaniu edycji.
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 dziesięciu proporcji od 21:9 do 9:16. Proporcje nie zmieniają ceny. |
resolution | Nie | 1k (domyślnie), 2k lub 4k. 1k i 2k kosztują tyle samo; 4k kosztuje więcej i ma 4096 pikseli na dłuższym boku. |
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 8 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ą. Wycena pokazuje cenę startową i maksymalną kwotę edycji. Odrzucone żądania nie są rozliczane.
| Specyfikacja | Cena |
|---|---|
| $0.0668 / obraz (Z opcją Official fallback: do $0.1072) |
| $0.0668 / obraz (Z opcją Official fallback: do $0.1072) |
| $0.118 / obraz (Z opcją Official fallback: do $0.192) |
Zastosowania
Zamiana zdjęć w okładki i plakaty
Dodaj tytuł, datę i linijkę tekstu do zaakceptowanego zdjęcia bez jego retuszowania.
Warianty nastroju i światła
Pokaż tę samą scenę przy świecach, o świcie lub w neonie klientowi, który wybiera kierunek.
Lokalne wersje obrazów kampanii
Podmień tekst na gotowym plakacie na przetłumaczoną linijkę dla każdego rynku, a zdjęcie i jego światło zostaw nietknięte.
Wskazówki
Zmieniaj jedną rzecz naraz
Polecenia z jedną zmianą utrzymują stabilność całej reszty; łącz edycje w łańcuch zamiast upychać je w jeden prompt.
Chroń ludzi
Po zmianie nazwij osobę, strój i pozę, które mają pozostać dokładnie takie same.
Licz się z czasem edycji
W tym modelu edycje trwają dłużej niż tekst na obraz: w naszych testach w 2k na oficjalnej trasie do około trzech minut, a nasze edycje w 1k na trasie ekonomicznej kończyły się w niecałą minutę.
Cytuj tekst razem z pozycją
Przy dodawanym tekście zacytuj każdą linijkę i napisz, gdzie ma się znaleźć: u góry na całej szerokości, w lewym dolnym rogu, obok logo.
Używaj 2k domyślnie
W tym modelu 1k i 2k kosztują tyle samo, więc edytuj w 2k, chyba że potrzebujesz mniejszego pliku.
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-pro/edit",
"input": {
"aspect_ratio": "auto",
"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.
