Felo API PlatformFelo API Platform
Zpět na modely

Nano Banana 2.1 API

Nano Banana 2.1 je model Google pro generování a úpravy obrázků z řady Gemini 3, postavený na Gemini 3.6 Flash, který nabízí kvalitu blízkou profesionální úrovni jako vysoce efektivní alternativa k Gemini 3 Pro Image.

Nano Banana 2.1 je nejnovější model pro generování a úpravy obrázků od Googlu, zařazený do řady Gemini 3 a postavený na modelu Gemini 3.6 Flash. Podporuje textové, obrázkové, video a PDF vstupy a generuje obrázky i text. Vyniká zejména v přesnosti a kontrole – nabízí úpravy pomocí masky, které mění pouze zadanou oblast a zachovávají okolní kompozici, konzistenci subjektů napříč scénami, osvětlením a úhly, a to jak u tváří, tak u identity. Zvládá až 14 referenčních obrázků na jeden prompt a udržuje konzistenci identity až pro 4 postavy a 10 objektů. Nechybí konverzační vícekolové úpravy, generování obrázků z videa ani podpora virtuálního zkoušení oblečení a generování postav.

Model je navržen pro profesionální tvorbu a úpravy obrázků s důrazem na přesnost a kontrolu. Hodí se pro rychlé iterativní úpravy v několika kolech, generování čitelného textu na plakátech a složitých diagramech, vytváření historicky přesných scén nebo komplexních infografik s využitím znalostí z dlouhého kontextu, lokalizované vykreslování textu v různých jazycích a vícekolové konverzační úpravy pro vyprávění příběhů a iterativní pracovní postupy. Dále podporuje fúzi více obrázků pro produktové scény, scény s více postavami a sériové podklady, stejně jako virtuální zkoušení oblečení a generování postav.

Oproti předchůdci přináší výrazné zlepšení vizuální kvality, následování instrukcí, vícekolové konzistence postav a vykreslování textu. Poskytuje kvalitu blízkou profesionální úrovni jako vysoce efektivní alternativa k Gemini 3 Pro Image. Rané uživatelské testování ukázalo silný výkon při vykreslování textu a složitých kompozičních instrukcí. Bezpečnostní politiky obsahu jsou podobné nebo lepší než u Gemini 3 Flash, včetně bezpečnosti dětí. Mezi omezení patří slabé vykreslování malého textu, které je při rozlišení 1K často rozmazané, problémy s dlouhými odstavci a celostránkovým textem, občasná nedokonalá konzistence postav mezi vstupními obrázky a výstupem a částečné problémy s následováním instrukcí a přetrváváním inkoustu při úpravách pomocí masky nebo kresby. Model také nepodporuje parametry temperature, topP, topK, seed ani logprobs a negeneruje zvuk, nepodporuje caching, spouštění kódu, vyhledávání souborů, volání funkcí ani strukturované výstupy.

Aktualizováno:

MODEL ID

gemini-nano-banana-2.1
Kontext
65.536K
Max. výstup
58.982K
Vstup
image / text
Výstup
image / text

Hlavní body

  • Kvalita blízká profesionální úrovni
  • Úpravy pomocí masky s přesnou kontrolou
  • Konzistence identity až pro 4 postavy a 10 objektů
  • Až 14 referenčních obrázků na prompt
  • Podpora rozlišení 1K, 2K a 4K
  • Vícekolové konverzační úpravy

Poskytovatelé

1 poskytovatelů

Porovnejte ceny API u různých poskytovatelů. Vyberte poskytovatele a zobrazte všechny poplatky a podmínky.

Poskytovatel · Podrobnosti k cenám
Dostupnost

Uvažování

Výchozí úroveň úsilí
minimal
Ve výchozím nastavení zapnuto
Ano
Vždy zapnuto
Ne
Dostupné úrovně úsilí
high / minimal / none

Rychlý start

Odešlete úlohu obrázku, kontrolujte stav a uložte obrázky. Příklady používají curl a standardní knihovnu Pythonu 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Získejte API klíč

Vytvořte klíč ve svém účtu Felo API Platform a nastavte jej jako proměnnou prostředí.

export FELO_API_KEY="YOUR_API_KEY"

2Odešlete první požadavek

Volitelné hodnoty závisí na modelu a nejsou zde nastaveny. Ověřte je v Playground. Pole jsou na stejné úrovni jako model a prompt, bez obalu input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "gemini-nano-banana-2.1"
}'

3Dotazovat úlohu

Odeslání vrátí task_id. Při queued nebo running kontrolujte každé 3 sekundy; při succeeded, failed nebo interrupted skončete. Maximálně čekejte 30 minut. Uchovejte created.json pro pokračování bez opakovaného odeslání.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Stáhnout výstup

Po úspěchu uložte outputs z task.json. Podporovány jsou HTTPS URL, objekty URL a b64_json. Podepsané URL stáhněte včas; stahování obrázků nepotřebuje API klíč.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Pro úpravu nahraďte vzorovou URL vlastní HTTPS URL obrázku nebo base64 data URL. Odešlete jednou a použijte stejné kroky kontroly a uložení.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "gemini-nano-banana-2.1",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Podporované parametry

  • n
  • seed
  • tools
  • top_p
  • reasoning
  • max_tokens
  • resolution
  • temperature
  • tool_choice
  • aspect_ratio
  • response_format
  • input_references
  • reasoning_effort
  • include_reasoning
  • structured_outputs

Chcete celou referenci?

Reference API →

Časté dotazy

Co je Nano Banana 2.1?

Nano Banana 2.1 je nejnovější model pro generování a úpravy obrázků od Googlu, zařazený do řady Gemini 3 a postavený na modelu Gemini 3.6 Flash. Podporuje textové, obrázkové, video a PDF vstupy a generuje obrázky i text. Vyniká zejména v přesnosti a kontrole – nabízí úpravy pomocí masky, které mění pouze zadanou oblast a zachovávají okolní kompozici, konzistenci subjektů napříč scénami, osvětlením a úhly, a to jak u tváří, tak u identity. Zvládá až 14 referenčních obrázků na jeden prompt a udržuje konzistenci identity až pro 4 postavy a 10 objektů. Nechybí konverzační vícekolové úpravy, generování obrázků z videa ani podpora virtuálního zkoušení oblečení a generování postav. Model je navržen pro profesionální tvorbu a úpravy obrázků s důrazem na přesnost a kontrolu. Hodí se pro rychlé iterativní úpravy v několika kolech, generování čitelného textu na plakátech a složitých diagramech, vytváření historicky přesných scén nebo komplexních infografik s využitím znalostí z dlouhého kontextu, lokalizované vykreslování textu v různých jazycích a vícekolové konverzační úpravy pro vyprávění příběhů a iterativní pracovní postupy. Dále podporuje fúzi více obrázků pro produktové scény, scény s více postavami a sériové podklady, stejně jako virtuální zkoušení oblečení a generování postav. Oproti předchůdci přináší výrazné zlepšení vizuální kvality, následování instrukcí, vícekolové konzistence postav a vykreslování textu. Poskytuje kvalitu blízkou profesionální úrovni jako vysoce efektivní alternativa k Gemini 3 Pro Image. Rané uživatelské testování ukázalo silný výkon při vykreslování textu a složitých kompozičních instrukcí. Bezpečnostní politiky obsahu jsou podobné nebo lepší než u Gemini 3 Flash, včetně bezpečnosti dětí. Mezi omezení patří slabé vykreslování malého textu, které je při rozlišení 1K často rozmazané, problémy s dlouhými odstavci a celostránkovým textem, občasná nedokonalá konzistence postav mezi vstupními obrázky a výstupem a částečné problémy s následováním instrukcí a přetrváváním inkoustu při úpravách pomocí masky nebo kresby. Model také nepodporuje parametry temperature, topP, topK, seed ani logprobs a negeneruje zvuk, nepodporuje caching, spouštění kódu, vyhledávání souborů, volání funkcí ani strukturované výstupy.

Jak se využití účtuje?

Faktura závisí na zvoleném poskytovateli, jeho cenách a vašem využití. Delší vstupy nebo jiné podmínky mohou mít jiné ceny. Účtováno podle skutečných nákladů na generování. Konečnou částku najdete ve faktuře.

Jaké typy vstupů model podporuje?

Nano Banana 2.1 přijímá textové, obrázkové, video a PDF vstupy a na výstupu poskytuje obrázky i text.

Jaké jsou limity kontextu a výstupu?

Model má kontextový limit 131 072 tokenů a limit výstupu 32 768 tokenů.

Pro jaké úlohy se model nejlépe hodí?

Hodí se pro profesionální tvorbu a úpravy obrázků, rychlé iterativní úpravy, generování čitelného textu na plakátech a diagramech, vícekolové konverzační úpravy, fúzi více obrázků a virtuální zkoušení oblečení.

Jak se liší od modelu Nano Banana 2?

Nano Banana 2.1 je aktualizací modelu Nano Banana 2, který je postaven na Gemini 3.1 Flash Image. Přináší vylepšenou vizuální kvalitu, následování instrukcí, vícekolovou konzistenci postav a vykreslování textu.

Jaké rozlišení obrázků model podporuje?

Model podporuje rozlišení 1K, 2K a 4K, přičemž výchozí je 1K.

Podporuje model parametry jako temperature nebo seed?

Ne, model nepodporuje parametry temperature, topP, topK, seed ani logprobs; jejich nastavení vrací chybu API.

Související modely