Source: https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/ Canonical: https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/ Language: hu # Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) [Markdown](https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/index.md) · [JSON](https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/facts.json) ## [Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)](https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/) A Nano Banana 2 (Gemini 3.1 Flash Image Preview) szövegből és vizuális referenciákból készít és szerkeszt képeket. Dokumentált erősségei a témák állandósága, a képen belüli szöveg és lokalizáció, a beszélgetéses módosítások, valamint a kompozíció, képarány és felbontás kreatív szabályozása. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/#method-0) - [**Ailoot Ultra · Képek** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/google-gemini-3-1-flash-image-preview/#method-2) A modellről Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók. A Nano Banana 2 a Google Gemini 3.1 Flash Image modellje képgeneráláshoz és beszélgetéses szerkesztéshez. Ez a bejegyzés megőrzi a pontos Preview-azonosságot. Írott leírás meghatározhat új vizuális anyagot, egy bemeneti kép pedig rögzítheti a módosítandó témát, megjelenést vagy kompozíciót. Az eredmény képet és kísérőszöveget is tartalmazhat. A Google bevezető anyaga a világismeretet, a szövegmegjelenítést és a témák állandóságát hangsúlyozza, a jelenet kapcsolódó fordulókon át történő finomításának lehetősége mellett. Forrásokra támaszkodó vizuális alkotáshoz a dokumentált modell webes és képkeresési információval alapozhatja meg a generálást. Ez olyan feladatokat támogat, mint egy helyszín által inspirált illusztráció vagy megadott információra épülő diagram. Határozza meg a megjelenítendő forrástényeket, és különböztesse meg őket a művészi döntésektől. A kereséssel támogatott generálás nem teszi a végső kép minden részletét ellenőrzött állítássá. Ha egy terméknek, nevezetességnek vagy diagramnak pontosnak kell lennie, adja meg a mérvadó referenciáját, és azzal vesse össze a kimenetet. A bejelentés javított képen belüli szövegmegjelenítést és lokalizációt ismertet. Poszterhez, infografikához vagy marketing-látványtervhez adja meg minden szövegelem pontos szövegét, nyelvét és szerepét. Először véglegesítse a szöveget, majd a képi útmutató ajánlása szerint kérje az azt tartalmazó vizuális anyagot. Magyarázza el az olvasási sorrendet és a relatív hangsúlyt, hogy a címsor, képaláírás és diagramcímke ne keveredjen össze. Publikációban való felhasználás előtt ellenőrizze a helyesírást, az írásjeleket és a címke kapcsolatát az ábrázolt elemmel. A kreatív vezérlők között képarány és felbontás szerepel. A bejelentés az 1K, 2K és 4K lehetőségek mellé 512 képpontos kimenetet, továbbá 4:1, 1:4, 8:1 és 1:8 képarányokat ad hozzá. A fejlesztői útmutató a minimal gondolkodást nevezi meg alapértelmezésnek, a high gondolkodást pedig összetettebb kompozíciókhoz választható lehetőségnek. A kompozíció előtt válassza ki a felhasználási célt: egy álló történetkép, széles banner és tömör diagram eltérő helyet igényel a témának és a feliratoknak. E beállítások a fejlesztő generálási folyamatát írják le ennél a sorozatnál, nem egy meglévő kész anyag automatikus átméretezését. A témák állandóságához címkézze minden referencia szerepét: termékmegjelenés, karakterazonosság, háttér vagy vizuális stílus. Határozza meg a megőrzendő részleteket, majd nevezze meg a módosítandó elemeket. Egy önálló feladat a megadott termékfotót új jelenetbe helyezheti alakjának, anyagának és látható márkajelzéseinek megőrzésével. Illusztrált sorozatnál tartsa meg ugyanazokat a referenciákat, és határozza meg, mely jelenetspecifikus részletek változnak. A több referencia nem helyettesíti az egyértelmű utasítást arra, mivel járulnak hozzá az egyes képek. A beszélgetéses szerkesztés konkrét módosításhoz hasznos. Kérje egy tárgy, háttér vagy világítás módosítását az elfogadott kompozíció megtartásával. A fejlesztő útmutatója szemantikus maszkolást ismertet, amelyben a szerkesztendő területet szavak azonosítják. Többfordulós munkánál őrizze meg a beszélgetést és a gondolkodási kontextus szükséges metaadatait a kiválasztott interfészben; a Gemini 3 útmutató elmagyarázza, hogy a gondolkodási aláírások segítik e kontextus továbbvitelét. Egy változatlan terület leírása az eredetivel összevetendő utasítás, nem garancia arra, hogy minden pixel azonos marad. A Gemini 3 fejlesztői táblázat kifejezetten a gemini-3.1-flash-image-preview nevet adja meg 128K bemeneti és 32K kimeneti kerettel. Generálás rögzítésekor őrizze meg a pontos Preview-modellnevet. Az elérhető referencia-, kimeneti és felbontási beállításokat a forrásképekkel és a kéréssel együtt tartsa meg, hogy a módosítás következetesen reprodukálható legyen. Módosításhoz őrizze meg ugyanazokat a forrásreferenciákat, és határozza meg a pontos vizuális változtatást, minden bemenet elfogadott szerepének megtartásával. A képi útmutató figyelmeztet, hogy a kért képszámot a modell nem mindig követi, és SynthID-jelölést említ a generált képeknél. Ellenőrizzen minden visszakapott képet és kísérőszöveget, ne feltételezze, hogy az eredmény egyetlen rögzített kép. Vizsgálja meg a téma azonosságát, a tárgyak számát, a képen belüli szöveget, a kompozíciót és a referenciahűséget a tervezett megjelenítési méretben. Összetett jelenetnél logikus sorrendben határozza meg az összetevőket, és pozitívan írja le a kívánt megjelenést. Hasznos eredmény egy ellenőrzött vizuális anyag, amelynek forrásreferenciái és pontos modellazonossága megmaradnak a következő szerkesztéshez. Gyakorlati feladat ### Gyakorlati feladat Technikai példa angolul ``` Create a four-stage growing guide Create a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants. ``` #### Várt eredmény ``` An image with four distinct growing stages in the specified order and a consistent illustration style. ``` #### Az eredmény ellenőrzése ``` Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) Google /`google/gemini-3.1-flash-image-preview` ### Kezdő lépések A Nano Banana 2 (Gemini 3.1 Flash Image Preview) szövegből és vizuális referenciákból készít és szerkeszt képeket. Dokumentált erősségei a témák állandósága, a képen belüli szöveg és lokalizáció, a beszélgetéses módosítások, valamint a kompozíció, képarány és felbontás kreatív szabályozása. Elfogadott bemenetek Szöveg Eredmények Szöveg ### Elérhető az Ailootban · bemenetek és metódusok **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Bemenet `text` Kimenet `text` Kimeneti formátum json vagy SSE | Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett | | --- | --- | --- | --- | --- | | Mező`model` | Típus`string` | KövetelményKötelező | Értékek és korlátok google/gemini-3.1-flash-image-preview | Alapértelmezett— | | Mező`messages` | Típus`message[]` | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 | Alapértelmezett— | | Mező`messages[].role` | Típus`string` | KövetelményKötelező | Értékek és korlátok Példák: system, user, assistant, tool, function Feltételek: Ezeket a szerepeket a forráskód kompatibilitási típusai kifejezetten reprezentálják; a pontos szerepkészlet továbbra is modellspecifikus. Modelltől függ | Alapértelmezett— | | Mező`messages[].content` | Típus`string\|content_part[]\|null` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— | | Mező`messages[].tool_calls` | Típus`tool_call[]` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— | | Mező`messages[].tool_call_id` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Akkor alkalmazandó, ha: role=tool; használja a ténylegesen visszaadott ID-t | Alapértelmezett— | | Mező`messages[].name` | Típus`string` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— | | Mező`messages[].reasoning_content` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Akkor alkalmazandó, ha: Küldje vissza a ténylegesen visszaadott gondolkodási tartalmat, ha ez a modell használja | Alapértelmezett— | | Mező`messages[].reasoning_details` | Típus`object\|array` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`max_tokens` | Típus`integer` | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Modelltől függ | Alapértelmezett— | | Mező`max_completion_tokens` | Típus`integer` | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Modelltől függ | Alapértelmezett— | | Mező`stream` | Típus`boolean` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezettfalse | | Mező`stream_options.include_usage` | Típus`boolean` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`temperature` | Típus`number` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`top_p` | Típus`number` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`stop` | Típus`string\|string[]` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`tools` | Típus`function_tool[]` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`tools[].type` | Típus`string` | KövetelményOpcionális | Értékek és korlátok function Modelltől függ | Alapértelmezett— | | Mező`tools[].function.name` | Típus`string` | KövetelményKötelező | Értékek és korlátok Akkor alkalmazandó, ha: Függvényeszköz megadva | Alapértelmezett— | | Mező`tools[].function.description` | Típus`string` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— | | Mező`tools[].function.parameters` | Típus`JSON_schema` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— | | Mező`tool_choice` | Típus`string\|object` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`parallel_tool_calls` | Típus`boolean` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`response_format` | Típus`object` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`reasoning_effort` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`reasoning` | Típus`object` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`service_tier` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`instructions` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Kompatibilitási mező | Alapértelmezett— | | Mező`functions` | Típus`function[]` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`function_call` | Típus`string\|object` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`prompt_cache_options` | Típus`object` | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— | | Mező`modalities` | Típus`string[]` | KövetelményOpcionális | Értékek és korlátok text | Alapértelmezett— | | Mező`provider` | Típus`object` | KövetelményOpcionális | Értékek és korlátok Feltételek: A provider.options elutasításra kerül ezen az Ultra szöveges útvonalon | Alapértelmezett— | | Mező`cache_control.ttl` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Feltételek: Az 1h elutasításra kerül a tényleges prompt-gyorsítótárazási helyeken | Alapértelmezett— | Bemeneti anyagok kombinációi **Szöveg** · UTF8 szöveg `messages[].content` Metódus paraméterei és életciklusa | Paraméter | Szerződés | | --- | --- | | Paraméter`content_type` | Szerződésapplication/json | | Paraméter`required` | Szerződésmodel, messages | | Paraméter`material_types` | Szerződéstext | | Paraméter`messages` | Szerződésüzenettömb role/content szerkezettel | | Paraméter`file_material` | Szerződésa tényleges UTF-8 dokumentum szó szerinti szövegként beillesztve; nincs kikövetkeztetett fájlazonosító | | Paraméter`optional_controls` | Szerződésstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Paraméter`control_scope` | Szerződésmodellspecifikus; a felhasználói függvényeszközök eltérnek a hosztolt eszközöktől | | Paraméter`output_modalities` | Szerződéstext | | Paraméter`hosted_operations` | Szerződésfalse | | Paraméter`multimodal_input_binding` | Szerződésnull | Életciklus: `synchronous_or_streamed` Küldje el a pontos modellazonosítót a messages mellett. A kontextushossz nem kimeneti felső korlát. Egy szövegfájl szó szerinti szöveget adhat meg; a kép-/hang-/fájlobjektum-bemenetek pontos hozzárendelést igényelnek. ### Díjcsomagok A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek. Gyors mód Normál díjszabás Ha a gyors mód van kiválasztva Flex mód Normál díjszabás Ha a flex mód van kiválasztva Maximális gondolkodási ráfordítás Normál díjszabás Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik Gondolkodási ráfordítás · high Normál díjszabás Ha a gondolkodási ráfordítás értéke high Gondolkodási ráfordítás · minimal Normál díjszabás Ha a gondolkodási ráfordítás értéke minimal Explicit gyorsítótárazás díjai Nincs engedélyezve Ha explicit gyorsítótárazást kérnek #### Ailoot-díjak #### Árak beállításonként Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon. | Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj | | --- | --- | --- | --- | --- | | BeállításTokenenkénti alapárak | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek **$0.001** / 1K token Kimenet · Kimeneti tokenek **$0.006** / 1K token Bemenet · Gyorsítótár olvasása **—** / 1K token Bemenet · Írás a gyorsítótárba **—** / 1K token Bemenet · Írás a gyorsítótárba, 1 óra **—** / 1K token Kimenet · Kimeneti képtokenek **$0.12** / 1K képtoken | | BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek **$0.001** / 1K token Kimenet · Kimeneti tokenek **$0.006** / 1K token Bemenet · Gyorsítótár olvasása **—** / 1K token Bemenet · Írás a gyorsítótárba **—** / 1K token Bemenet · Írás a gyorsítótárba, 1 óra **—** / 1K token | #### A referencia-díjszabás részletei A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják. google/gemini-3.1-flash-image-preview #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | Beállításgoogle/gemini-3.1-flash-image-preview · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet **0,001 USD** / 1K token Kimenet · Kimenet **0,12 USD** / 1K token | google/gemini-3.1-flash-image-preview #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | Beállításgoogle/gemini-3.1-flash-image-preview · Alapértelmezett konfiguráció | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet **0,001 USD** / 1K token Kimenet · Kimenet **0,12 USD** / 1K token | google/gemini-3.1-flash-image-preview #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | Beállításgoogle/gemini-3.1-flash-image-preview · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet **0,00 USD** hívásonként Kimenet · Kimenet **0,16 USD** hívásonként | google/gemini-3.1-flash-image-preview #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | Beállításgoogle/gemini-3.1-flash-image-preview · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet **0,00 USD** hívásonként Kimenet · Kimenet **0,32 USD** hívásonként | google/gemini-3.1-flash-image-preview #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | Beállításgoogle/gemini-3.1-flash-image-preview · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet **0,00 USD** hívásonként Kimenet · Kimenet **0,00 USD** hívásonként | Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | BeállításGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemeneti tokenek **0,001 USD** / 1K token Kimenet · Kimeneti tokenek **0,006 USD** / 1K token Kimenet · Kimeneti kép **0,12 USD** / 1K token Kimenet · Webes keresés **0,028 USD** keresésenként | Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. [A foglalás és az elszámolás működése →](https://ailoot.ai/docs/hu/billing/reserve/) ### Példakérések #### Ailoot Ultra · OpenAI Chat curlPython SDKPython-adatfolyam ```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-3.1-flash-image-preview", "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-3.1-flash-image-preview',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-3.1-flash-image-preview',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") ``` ### Eredmények fogadása és mentése #### Ailoot Ultra · OpenAI Chat json vagy SSE ##### Őrizzen meg minden elkészült eredményt Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt. Őrizze meg az összes válaszváltozatot és azok tartalmát/eszközhívásait/gondolkodási tartalmát. SSE esetén válaszváltozat- és eszközindex szerint állítsa össze a részleges frissítéseket, és tartsa meg a végső befejezési okot és a használati adatokat. ##### Ha az eredeti választ ellenőrizni kell Őrizze meg a kérés-/válaszazonosítókat és a fejléceket. Nincs megadva általános URL a szöveges feladatok lekéréséhez. Válaszmezők | Mező | Típus | | --- | --- | | Mező`choices[].index` | Típusinteger | | Mező`choices[].message.content` | Típusstring\|null | | Mező`choices[].message.tool_calls` | Típustool\_call\[\] | | Mező`choices[].message.reasoning_content` | Típusstring | | Mező`choices[].message.reasoning_details` | Típusobject\|array | | Mező`choices[].finish_reason` | Típusstring\|null | | Mező`usage` | Típusobject | Hibák és következő lépések | Válasz | Feltétel | Következő lépés | | --- | --- | --- | | Válasz400 · `invalid_request_error` | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. | ### Álnevek #### Modell álnevei **Ailoot Ultra** [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) #### Metódusútvonalak álnevei `/v1/images` #### Kapcsolódó modellazonosítók [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) **Ailoot Ultra · Képek** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/hu/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=images) Google /`google/gemini-3.1-flash-image-preview` ### Kezdő lépések A Nano Banana 2 (Gemini 3.1 Flash Image Preview) szövegből és vizuális referenciákból készít és szerkeszt képeket. Dokumentált erősségei a témák állandósága, a képen belüli szöveg és lokalizáció, a beszélgetéses módosítások, valamint a kompozíció, képarány és felbontás kreatív szabályozása. Elfogadott bemenetek Szöveg · Képek Eredmények Képek ### Elérhető az Ailootban · bemenetek és metódusok **Ailoot Ultra · Képek** `POST /v1/images/generations` Bemenet `text`, `image` Kimenet `image` | Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett | | --- | --- | --- | --- | --- | | Mező`model` | Típus`string` | KövetelményKötelező | Értékek és korlátok google/gemini-3.1-flash-image-preview | Alapértelmezett— | | Mező`prompt` | Típus`string` | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— | | Mező`resolution` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 512, 1K, 2K, 4K | Alapértelmezett— | | Mező`aspect_ratio` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Alapértelmezett— | | Mező`n` | Típus`integer` | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 1 | Alapértelmezett— | | Mező`input_references` | Típus`array` | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 14 | Alapértelmezett— | | Mező`provider` | Típus`object` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— | Metódus paraméterei és életciklusa | Paraméter | Szerződés | | --- | --- | | Paraméter`content_type` | Szerződésapplication/json | | Paraméter`required` | Szerződésmodel, prompt | | Paraméter`material_types` | Szerződéstext, image | Életciklus: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · A ténylegesen visszaadott task\_id vagy a médiatár bejegyzése `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Díjcsomagok ##### A végső díj számítása A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel. A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek. Gyors mód Nincs megadva Ha a gyors mód van kiválasztva Flex mód Nincs megadva Ha a flex mód van kiválasztva Maximális gondolkodási ráfordítás Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik #### Becsült díjak összehasonlításhoz #### Árak beállításonként Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon. | Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj | | --- | --- | --- | --- | | BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra **—** / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra **—** / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra **—** / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra **—** / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra **—** / 1K token | | BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra **$0.49152** becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. | Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. [A foglalás és az elszámolás működése →](https://ailoot.ai/docs/hu/billing/reserve/) ### Példakérések #### Ailoot Ultra · Képek 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-3.1-flash-image-preview', '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"