Source: https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/ Canonical: https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/ Language: hu # Google: Nano Banana 2.1 [Markdown](https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/index.md) · [JSON](https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/facts.json) ## [Google: Nano Banana 2.1](https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/) A Gemini Nano Banana 2.1 beszélgetésben generál és szerkeszt képeket szövegből és vizuális anyagból. Javítja a szövegmegjelenítést, az infografikák elrendezését és a többfordulós következetességet, 1K–4K kimenettel és legfeljebb 14 referenciaképpel egy meghatározott vizuális feladatleíráshoz. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/#method-0) - [**Ailoot Ultra · Képek** `POST /v1/images/generations` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/hu/google-gemini-nano-banana-2-1/#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 Gemini Nano Banana 2.1 a Google képgeneráló és beszélgetéses képszerkesztő modellje. A Nano Banana 2 frissítése, a vizuális élethűség, az utasításkövetés, a szövegmegjelenítés és az egymást követő szerkesztések közötti karakterállandóság javításával. Bemeneti táblázatában szöveg, kép, videó és PDF szerepel, kimenete pedig kép és szöveg. Ez termékjelenethez, infografikához vagy több konkrét módosítással fejlődő vizuális sorozathoz teszi hasznossá. A modell 1K, 2K és 4K kimenetet kínál, 1K alapértelmezéssel. Nem örökli a Nano Banana 2 0.5K lehetőségét. A dokumentált képarányok között 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 és 21:9 szerepel, valamint az álló vagy panoráma 1:4, 4:1, 1:8 és 8:1 formátumok. A Google az utóbbi széles és magas formátumoknál, 2K és 4K méretben javított mozaikos képhibákat említ. A felbontási címkék méretkategóriák, nem egyetlen rögzített téglalap: egy négyzetes 4K kép 4096 × 4096 méretű, a dokumentált 16:9 arányú 4K kimenet pedig 5504 × 3072. A szöveg a vizuális munkafolyamat jelentős része. A modellt olvasható, stilizált feliratok megjelenítésére és az infografikai elemek pontosabb elrendezésére tervezték. Készítse elő a pontos címsort, címkéket és olvasási sorrendet, majd ezzel a jóváhagyott szöveggel kérje a képet. Étlapnál, diagramnál vagy útmutató ábránál nevezze meg a felirat és a vizuális elem kapcsolatát. A Google a szöveg előzetes megírását, majd a kép kérését javasolja, hogy a vizuális kompozíció véglegesített szöveges feladatleírásból induljon. A referenciaképek egyesítése legfeljebb 14 képet támogat. A dokumentált profil legfeljebb négy karakter állandóságára és legfeljebb tíz tárgy hű megőrzésére terjed ki. Rendeljen minden referenciához szerepet: felismerhetően megőrzendő termék, karaktermegjelenés, kívánt háttér vagy vizuális stílus. Szemléltető termékfeladat: „Az A képet használja a palack alakjához és címkéjéhez. A B képet használja a felülethez és a világításhoz. Hagyja változatlanul a terméket, helyezze egy összehajtott törölköző mellé, és fölötte hagyjon üres helyet a megadott címsornak.” A Google Web Search és Image Search alapú forráshoz kötés aktuális információt és vizuális kontextust biztosíthat a generáláshoz. Az Image Search lekért webes képeket ad referenciaként; a szokásos webes forráshoz kötés a témával kapcsolatos információt adja. Ez tényalapú grafikához vagy olyan jelenethez hasznos, amelynek megjelenése egy valós tárgytól függ. A képkeresési munkafolyamat erre a célra nem támogatja valós embereket ábrázoló képek lekérését. A Google dokumentált munkafolyamatában a forráshoz kötött válaszok forrás- és attribúciós metaadatokat tartalmaznak, ezért az alkalmazásnak ezeket meg kell őriznie a generált eredménnyel együtt. A gondolkodás minimal, medium és high szinten állítható, ennél a konkrét modellnél medium alapértelmezéssel. Segít a modellnek a kompozíció és az összetettebb utasítások átgondolásában a végső kimenet előtt. A képi útmutató a folyamatban köztes kompozíciós képeket is leír; ezek különböznek a kívánt végső eredménytől. Kifejezetten válassza ki a szükséges végső elrendezést, képarányt és felbontást, ne várja a prompt leírásától önmagában minden kimeneti beállítás rögzítését. A beszélgetéses szerkesztés lehetővé teszi, hogy egy további kérés a meglévő eredmény egy részét módosítsa: megváltoztassa a fényt, elmozdítson egy tárgyat vagy lefordítsa a címkéket a kompozíció többi részének megőrzésével. Vigye tovább a korábbi képet vagy interakciót a következő fordulóba, és nevezze meg a kért módosítást és a megőrzendő jellemzőket is. Karaktersorozatnál használjon következetes megjelenési referenciákat, és adjon pózreferenciát, ha új nézőpont vagy összetett póz számít. Gyakorlati módosítási feladat lehet: „Őrizze meg a terméket, a címkéket és az elrendezést; csak a háttér legyen melegebb szürke.” A modelltáblázat 131 072 tokenes bemeneti és 32 768 tokenes kimeneti korlátot ad meg. A képgenerálás és a keresésalapú forráshoz kötés támogatott, míg a hanggenerálás, a kódvégrehajtás, a függvényhívás, a strukturált kimenetek, a gyorsítótárazás, a fájlkeresés, az URL-kontextus és a Live API ennél a kiadásnál nem szerepel támogatottként. A videó információt adhat egy generált állóképhez; ettől a modell nem válik videógenerátorrá. A Google azt is megjegyzi, hogy a pontos képszámot kérő utasítás nem feltétlenül eredményezi az adott darabszámot. Minden generált kép SynthID-vízjelet tartalmaz. Hasznos első feladatleíráshoz adja meg a kép célját, témáját, kompozícióját, világítását, kameranézetét, kötelező szövegét és kimeneti formáját. Kérjen például álló infografikát három feliratozott lépéssel, olvasható címmel és meghatározott színhierarchiával, majd a következő szerkesztés előtt ellenőrizze a szöveget és az elemek egymáshoz viszonyított elhelyezését. Az eredmény termékillusztrációvá, szerkesztőségi grafikává vagy designreferenciává válhat, a kiválasztott kép és magyarázó szövegének együttes megőrzésével. Gyakorlati feladat ### Gyakorlati feladat Technikai példa angolul ``` Refine an approved poster background Edit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image. ``` #### Várt eredmény ``` One edited poster with the original wording and layout preserved over a warm ivory background. ``` #### Az eredmény ellenőrzése ``` Compare every word and element position against the supplied poster, then inspect text contrast. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-nano-banana-2.1` [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/hu/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) Google /`google/gemini-nano-banana-2.1` ### Kezdő lépések A Gemini Nano Banana 2.1 beszélgetésben generál és szerkeszt képeket szövegből és vizuális anyagból. Javítja a szövegmegjelenítést, az infografikák elrendezését és a többfordulós következetességet, 1K–4K kimenettel és legfeljebb 14 referenciaképpel egy meghatározott vizuális feladatleíráshoz. 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-nano-banana-2.1 | 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.003** / 1K token Kimenet · Kimeneti tokenek **$0.015** / 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.06** / 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.003** / 1K token Kimenet · Kimeneti tokenek **$0.015** / 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: Nano Banana 2.1 #### Árak beállításonként | Beállítás | Elszámolási feltételek | Díj | | --- | --- | --- | | BeállításGoogle: Nano Banana 2.1 · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemeneti tokenek **0,003 USD** / 1K token Kimenet · Kimeneti tokenek **0,015 USD** / 1K token Kimenet · Kimeneti kép **0,06 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-nano-banana-2.1", "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-nano-banana-2.1',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-nano-banana-2.1',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-nano-banana-2.1`](https://ailoot.ai/models/hu/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) #### Metódusútvonalak álnevei `/v1/images` #### Kapcsolódó modellazonosítók [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/hu/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) **Ailoot Ultra · Képek** `POST /v1/images/generations` `google/gemini-nano-banana-2.1` [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/hu/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=images) Google /`google/gemini-nano-banana-2.1` ### Kezdő lépések A Gemini Nano Banana 2.1 beszélgetésben generál és szerkeszt képeket szövegből és vizuális anyagból. Javítja a szövegmegjelenítést, az infografikák elrendezését és a többfordulós következetességet, 1K–4K kimenettel és legfeljebb 14 referenciaképpel egy meghatározott vizuális feladatleíráshoz. 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-nano-banana-2.1 | 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 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.24576** 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-nano-banana-2.1', '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"