Source: https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/ Canonical: https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/ Language: cs # Google: Nano Banana (Gemini 2.5 Flash Image) [Markdown](https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/index.md) · [JSON](https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/facts.json) ## [Google: Nano Banana (Gemini 2.5 Flash Image)](https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/) Nano Banana (Gemini 2.5 Flash Image) generuje a upravuje obrázky z textu a obrázků. Jeho konverzační pracovní postup použijte k sestavení scény, změně vybraného prvku, kombinaci vizuálních referencí nebo zdokonalení produktového obrázku a přitom uveďte detaily, které mají zůstat zachovány. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/#method-0) - [**Ailoot Ultra · Obrázky** `POST /v1/images/generations` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/google-gemini-2-5-flash-image/#method-2) O modelu Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu. Gemini 2.5 Flash Image, známý také jako Nano Banana, je textový a obrazový model Googlu pro vizuální tvorbu a konverzační úpravy obrázků. Přijímá instrukci s volitelnými obrazovými referencemi a může vracet obrázky s doprovodným textem. Tato přesná edice 2.5 Flash Image se liší od Nano Banana 2, Nano Banana Pro a pozdějších obrazových modelů Lite. Jejím užitečným výsledkem je vygenerovaný nebo upravený vizuální výstup, nikoli odpověď obecného textového modelu Gemini 2.5. Přesná karta modelu uvádí 65,536 vstupních tokenů a 32,768 výstupních tokenů. Obrázky a instrukce tvoří součást vstupu a vrácený obrázek nebo text je součástí výsledku. Tabulka rozlišení v průvodci uvádí mezi podporovanými poměry stran výstup 1:1 při 1024×1024, 3:4 při 864×1184 a 16:9 při 1344×768. Před návrhem scény zvolte zamýšlený tvar zobrazení. Možnosti vysokého rozlišení pozdější obrazové edice Gemini by neměly být považovány za ovládací prvky dokumentované pro tento přesný model. Při tvorbě obrázku z textu určete námět, akci, prostředí, styl, osvětlení a pohled. Produktová ilustrace může použít dodanou vizuální identitu a požadovat jasně viditelný detail materiálu ve vhodném prostředí. Vysvětlete účel obrázku, aby model mohl vyhradit prostor pro námět a případný text. Fotografické popisy jako detailní pohled, kompozice shora nebo perspektiva z podhledu pomáhají vymezit záběr jasněji než seznam nesouvisejících stylových slov. Pro úpravu poskytněte původní obrázek a určete část ke změně. Průvodce výrobce popisuje přidávání či odebírání prvků, sémantické maskování, přenos stylu a kompozici pomocí referencí. Užitečný požadavek pojmenovává revizi i podmínky k zachování — například změnu pozadí při zachování tvaru, povrchu a etikety produktu. Při kombinaci referencí označte roli každého vstupu, například vzhled námětu, prostředí nebo styl. Průvodce uvádí, že tato edice dosahuje nejlepších výsledků při použití nejvýše tří vstupních obrázků; jde o praktické doporučení, nikoli důvod kombinovat neomezenou sadu protichůdných referencí. Konverzační zdokonalování může zachovat stejný námět a změnit konkrétní vizuální rozhodnutí. Požadujte vždy jednu související revizi a uchovávejte zdrojový obrázek i přijatý výsledek použitý pro daný krok konverzace. Popište, co má zůstat konzistentní a co se smí měnit. U posloupnosti výstupů výslovně určete společný námět, barvy a vizuální pravidla, místo abyste předpokládali, že je nový izolovaný prompt obnoví. Upravený obrázek porovnejte s referencí, než budete pokyn k zachování považovat za úspěšně splněný. U textu v obrázku nejprve stanovte přesné znění a poté požadujte obrázek obsahující tento text, jak doporučuje průvodce. Uveďte jazyk, pořadí čtení, umístění a relativní důraz popisků. Požadavek na infografiku by měl určit vztah, který každý popisek vysvětluje, a vizuální prvky, jež jej podporují. Při skutečné zobrazovací velikosti zkontrolujte pravopis, interpunkci a vizuální přiřazení; i čitelně vypadající generovaný popisek může změnit jméno, číslo nebo zamýšlený význam. Karta modelu pro tuto edici neuvádí přemýšlení, ukotvení ve vyhledávání, volání funkcí, spouštění kódu ani omezený strukturovaný výstup. Neuvádí ani generování zvuku nebo Live API. Dokumentovaným vstupem jsou text a obrázky, proto by k tomuto profilu neměly být připojovány funkce zpracování zvuku, videa a dokumentů z jiných modelů Gemini. Aplikace by měla výslovně zpracovávat vrácené části obsahu, místo aby předpokládala, že běžná prozaická odpověď obsahuje hotový obrazový výstup. Průvodce uvádí, že požadovaný počet obrázků nemusí být vždy dodržen a že generované obrázky obsahují značení SynthID. Každý vrácený obrázek zkontrolujte z hlediska kompozice, věrnosti námětu, počtu objektů a přesného znění. Má-li scéna několik součástí, popište jejich zamýšlené uspořádání v jasném pořadí a požadovaný vzhled vyjádřete pozitivně. S výsledkem zachovejte přesnou identitu modelu, prompt a reference. Díky tomu lze úlohu generování nebo úpravy vizuálu přezkoumat a pozdější revize má konkrétní výchozí bod. Praktická úloha ### Praktická úloha Technický příklad v angličtině ``` Change a product photo background Using the supplied product photograph, preserve the ceramic mug's shape, handle, glaze and existing logo exactly. Replace only the background with a pale stone tabletop and soft morning side light. Keep the camera angle and mug position. Remove unrelated background clutter and add no new lettering, props or decorative marks. ``` #### Očekávaný výsledek ``` An edited image retaining the reference mug while changing its setting and light as requested. ``` #### Ověření výsledku ``` Compare the result with the reference for mug geometry, logo fidelity, camera angle and removal of clutter. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) Google /`google/gemini-2.5-flash-image` ### Úvod Nano Banana (Gemini 2.5 Flash Image) generuje a upravuje obrázky z textu a obrázků. Jeho konverzační pracovní postup použijte k sestavení scény, změně vybraného prvku, kombinaci vizuálních referencí nebo zdokonalení produktového obrázku a přitom uveďte detaily, které mají zůstat zachovány. Přijímané vstupy Text Výsledky Text ### Dostupné v Ailoot · vstupy a metody **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Vstup `text` Výstup `text` Výstupní formát json nebo SSE | Pole | Typ | Požadavek | Hodnoty a limity | Výchozí | | --- | --- | --- | --- | --- | | Pole`model` | Typ`string` | PožadavekPovinné | Hodnoty a limity google/gemini-2.5-flash-image | Výchozí— | | Pole`messages` | Typ`message[]` | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 | Výchozí— | | Pole`messages[].role` | Typ`string` | PožadavekPovinné | Hodnoty a limity Příklady: system, user, assistant, tool, function Podmínky: Tyto role jsou výslovně zastoupeny typy kompatibility zdrojového kódu; přesná sada rolí zůstává specifická pro daný model. Závisí na modelu | Výchozí— | | Pole`messages[].content` | Typ`string\|content_part[]\|null` | PožadavekVolitelné | Hodnoty a limity | Výchozí— | | Pole`messages[].tool_calls` | Typ`tool_call[]` | PožadavekVolitelné | Hodnoty a limity | Výchozí— | | Pole`messages[].tool_call_id` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Platí, když: role=tool; použijte skutečně vrácené ID | Výchozí— | | Pole`messages[].name` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— | | Pole`messages[].reasoning_content` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Platí, když: Předávejte zpět skutečně vrácené uvažování tam, kde je tento model používá | Výchozí— | | Pole`messages[].reasoning_details` | Typ`object\|array` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`max_tokens` | Typ`integer` | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Závisí na modelu | Výchozí— | | Pole`max_completion_tokens` | Typ`integer` | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Závisí na modelu | Výchozí— | | Pole`stream` | Typ`boolean` | PožadavekVolitelné | Hodnoty a limity | Výchozífalse | | Pole`stream_options.include_usage` | Typ`boolean` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`temperature` | Typ`number` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`top_p` | Typ`number` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`stop` | Typ`string\|string[]` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`tools` | Typ`function_tool[]` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`tools[].type` | Typ`string` | PožadavekVolitelné | Hodnoty a limity function Závisí na modelu | Výchozí— | | Pole`tools[].function.name` | Typ`string` | PožadavekPovinné | Hodnoty a limity Platí, když: nástroj typu funkce je dodán | Výchozí— | | Pole`tools[].function.description` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— | | Pole`tools[].function.parameters` | Typ`JSON_schema` | PožadavekVolitelné | Hodnoty a limity | Výchozí— | | Pole`tool_choice` | Typ`string\|object` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`parallel_tool_calls` | Typ`boolean` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`response_format` | Typ`object` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`reasoning_effort` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`reasoning` | Typ`object` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`service_tier` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`instructions` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Pole kompatibility | Výchozí— | | Pole`functions` | Typ`function[]` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`function_call` | Typ`string\|object` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`prompt_cache_options` | Typ`object` | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— | | Pole`modalities` | Typ`string[]` | PožadavekVolitelné | Hodnoty a limity text | Výchozí— | | Pole`provider` | Typ`object` | PožadavekVolitelné | Hodnoty a limity Podmínky: provider.options je na této textové trase Ultra odmítáno | Výchozí— | | Pole`cache_control.ttl` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Podmínky: Hodnota 1h je ve skutečných umístěních mezipaměti promptů odmítána | Výchozí— | Kombinace vstupních materiálů **Text** · text UTF8 `messages[].content` Parametry a životní cyklus metody | Parametr | Kontrakt | | --- | --- | | Parametr`content_type` | Kontraktapplication/json | | Parametr`required` | Kontraktmodel, messages | | Parametr`material_types` | Kontrakttext | | Parametr`messages` | Kontraktpole zpráv se strukturou role/content | | Parametr`file_material` | Kontraktskutečný dokument UTF-8 vložený jako doslovný text; ID souboru se neodvozuje | | Parametr`optional_controls` | Kontraktstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parametr`control_scope` | Kontraktspecifické pro model; nástroje uživatelských funkcí se liší od hostovaných nástrojů | | Parametr`output_modalities` | Kontrakttext | | Parametr`hosted_operations` | Kontraktfalse | | Parametr`multimodal_input_binding` | Kontraktnull | Životní cyklus: `synchronous_or_streamed` Odešlete přesné ID modelu spolu s messages. Délka kontextu není limitem výstupu. Textový soubor může dodat doslovný text; obrazové/zvukové vstupy a vstupy v podobě souborových objektů vyžadují přesnou vazbu. ### Tarify Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody. Rychlý režim Standardní sazba Při výběru rychlého režimu Režim flex Standardní sazba Při výběru režimu flex Maximální intenzita uvažování Standardní sazba Když se při maximální intenzitě uvažování použije výchozí úprava (default) Ceny explicitní mezipaměti Není zapnuto Při požadavku na explicitní mezipaměť #### Sazby Ailoot #### Ceny podle konfigurace Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu. | Konfigurace | Tabulka sazeb | Tokeny kontextu, více než | Tokeny kontextu, do uvedené hodnoty včetně | Poplatek | | --- | --- | --- | --- | --- | | KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Tokeny kontextu, více než— | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny **$0.0006** / 1K tokenů Výstup · Výstupní tokeny **$0.005** / 1K tokenů Vstup · Čtení z mezipaměti **$0.00006** / 1K tokenů Vstup · Zápis do mezipaměti **$0.0001666666666666666** / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina **—** / 1K tokenů Výstup · Tokeny výstupního obrázku **$0.06** / 1K obrazových tokenů | | KonfiguracePásmo délky požadavku 1 | Tabulka sazeb— | Tokeny kontextu, více než0 | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny **$0.0006** / 1K tokenů Výstup · Výstupní tokeny **$0.005** / 1K tokenů Vstup · Čtení z mezipaměti **$0.00006** / 1K tokenů Vstup · Zápis do mezipaměti **$0.0001666666666666666** / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina **—** / 1K tokenů | #### Podrobnosti referenčního tarifu Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot. google/gemini-2.5-flash-image #### Ceny podle konfigurace | Konfigurace | Podmínky účtování | Poplatek | | --- | --- | --- | | Konfiguracegoogle/gemini-2.5-flash-image · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup **0,0006 US$** / 1K tokenů Výstup · Výstup **0,06 US$** / 1K tokenů | Google: Nano Banana (Gemini 2.5 Flash Image) #### Ceny podle konfigurace | Konfigurace | Podmínky účtování | Poplatek | | --- | --- | --- | | KonfiguraceGoogle: Nano Banana (Gemini 2.5 Flash Image) · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstupní tokeny **0,0006 US$** / 1K tokenů Výstup · Výstupní tokeny **0,005 US$** / 1K tokenů Vstup · Vstupní obrázek **0,0006 US$** / 1K tokenů Výstup · Výstupní obrázek **0,06 US$** / 1K tokenů Vstup · Zvukový vstup **0,002 US$** / 1K tokenů Vstup · Čtení zvuku z mezipaměti **0,0002 US$** / 1K tokenů Výstup · Vyhledávání na webu **0,028 US$** za vyhledání Výstup · Tokeny uvažování **0,005 US$** / 1K tokenů Vstup · Čtení z mezipaměti **0,00006 US$** / 1K tokenů Vstup · Zápis do mezipaměti · 5 minut **≈0,000167 US$** / 1K tokenů | Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. [Jak funguje rezervace a vyúčtování →](https://ailoot.ai/docs/cs/billing/reserve/) ### Příklady požadavků #### Ailoot Ultra · OpenAI Chat curlPython SDKStreamování v Pythonu ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-2.5-flash-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Přijímání a ukládání výsledků #### Ailoot Ultra · OpenAI Chat json nebo SSE ##### Uchovejte všechny dokončené výsledky Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu. Zachovejte každou volbu a její obsah/volání nástrojů/uvažování. V SSE sestavujte přírůstky podle indexu volby/nástroje a zachovejte konečný důvod ukončení i údaje o využití. ##### Pokud je nutné ověřit původní odpověď Zachovejte ID požadavků/odpovědí a hlavičky. Není dodána obecná URL pro načtení textové úlohy. Pole odpovědi | Pole | Typ | | --- | --- | | Pole`choices[].index` | Typinteger | | Pole`choices[].message.content` | Typstring\|null | | Pole`choices[].message.tool_calls` | Typtool\_call\[\] | | Pole`choices[].message.reasoning_content` | Typstring | | Pole`choices[].message.reasoning_details` | Typobject\|array | | Pole`choices[].finish_reason` | Typstring\|null | | Pole`usage` | Typobject | Chyby a další kroky | Odpověď | Podmínka | Další krok | | --- | --- | --- | | Odpověď400 · `invalid_request_error` | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. | ### Aliasy #### Aliasy modelu **Ailoot Ultra** [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) #### Aliasy cest metod `/v1/images` #### Související ID modelů [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) **Ailoot Ultra · Obrázky** `POST /v1/images/generations` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/cs/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=images) Google /`google/gemini-2.5-flash-image` ### Úvod Nano Banana (Gemini 2.5 Flash Image) generuje a upravuje obrázky z textu a obrázků. Jeho konverzační pracovní postup použijte k sestavení scény, změně vybraného prvku, kombinaci vizuálních referencí nebo zdokonalení produktového obrázku a přitom uveďte detaily, které mají zůstat zachovány. Přijímané vstupy Text · Obrázky Výsledky Obrázky ### Dostupné v Ailoot · vstupy a metody **Ailoot Ultra · Obrázky** `POST /v1/images/generations` Vstup `text`, `image` Výstup `image` | Pole | Typ | Požadavek | Hodnoty a limity | Výchozí | | --- | --- | --- | --- | --- | | Pole`model` | Typ`string` | PožadavekPovinné | Hodnoty a limity google/gemini-2.5-flash-image | Výchozí— | | Pole`prompt` | Typ`string` | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 | Výchozí— | | Pole`aspect_ratio` | Typ`string` | PožadavekVolitelné | Hodnoty a limity 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Výchozí— | | Pole`n` | Typ`integer` | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Maximum: 1 | Výchozí— | | Pole`input_references` | Typ`array` | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 3 | Výchozí— | | Pole`provider` | Typ`object` | PožadavekVolitelné | Hodnoty a limity | Výchozí— | Parametry a životní cyklus metody | Parametr | Kontrakt | | --- | --- | | Parametr`content_type` | Kontraktapplication/json | | Parametr`required` | Kontraktmodel, prompt | | Parametr`material_types` | Kontrakttext, image | Životní cyklus: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · skutečně vrácené task\_id nebo záznam v knihovně médií `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Tarify ##### Jak se vypočítá konečný poplatek Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím. Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody. Rychlý režim Neuvedeno Při výběru rychlého režimu Režim flex Neuvedeno Při výběru režimu flex Maximální intenzita uvažování Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default) #### Odhadované sazby pro srovnání #### Ceny podle konfigurace Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu. | Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek | | --- | --- | --- | --- | | KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání **—** / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání **—** / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání **—** / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání **—** / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání **—** / 1K tokenů | | KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání **$0.24576** odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. | Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. [Jak funguje rezervace a vyúčtování →](https://ailoot.ai/docs/cs/billing/reserve/) ### Příklady požadavků #### Ailoot Ultra · Obrázky curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-2.5-flash-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"