Source: https://ailoot.ai/models/sl/google-gemini-3-1-flash-image-preview/ Canonical: https://ailoot.ai/models/sl/google-gemini-3-1-flash-image-preview/ Language: sl # Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) [Markdown](https://ailoot.ai/models/sl/google-gemini-3-1-flash-image-preview/index.md) · [JSON](https://ailoot.ai/models/sl/google-gemini-3-1-flash-image-preview/facts.json) ## [Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)](https://ailoot.ai/models/sl/google-gemini-3-1-flash-image-preview/) Nano Banana 2 (Gemini 3.1 Flash Image Preview) ustvarja in ureja slike iz besedila in vizualnih referenc. Njegove dokumentirane prednosti vključujejo doslednost motivov, besedilo v sliki in lokalizacijo, spremembe skozi pogovor ter ustvarjalni nadzor nad kompozicijo, razmerjem stranic in ločljivostjo. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/sl/google-gemini-3-1-flash-image-preview/#method-0) - [**Ailoot Ultra · Slike** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/sl/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/sl/google-gemini-3-1-flash-image-preview/#method-2) O modelu Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo. Nano Banana 2 je Googlov model Gemini 3.1 Flash Image za ustvarjanje slik in urejanje skozi pogovor. Ta vnos ohranja natančno identiteto Preview. Pisni opis lahko določi nov vizualni prikaz, vhodna slika pa motiv, videz ali kompozicijo, ki jo je treba spremeniti. Rezultat lahko vsebuje sliko in spremljevalno besedilo. Googlovo gradivo ob predstavitvi poudarja znanje o svetu, izris besedila in doslednost motivov ter možnost izpopolnjevanja prizora skozi povezane izmenjave. Pri vizualnem ustvarjanju, utemeljenem z viri, lahko dokumentirani model pri ustvarjanju uporabi informacije iz spletnega in slikovnega iskanja. To podpira naloge, kot sta ilustracija po navdihu lokacije ali diagram na podlagi priloženih informacij. Določite izvorna dejstva, ki morajo biti predstavljena, in jih ločite od umetniških odločitev. Ustvarjanje ob pomoči iskanja ne pomeni, da je vsaka podrobnost na končni sliki preverjena trditev. Če mora biti izdelek, znamenitost ali diagram natančen, priložite merodajno referenco in izhod preverite glede nanjo. Predstavitev opisuje izboljšan izris besedila v sliki in lokalizacijo. Pri plakatu, infografiki ali marketinški maketi podajte natančno ubeseditev, jezik in vlogo vsakega besedilnega elementa. Najprej dokončno določite besedilo, nato zahtevajte vizualni prikaz, ki ga vsebuje, kot priporoča vodnik za slike. Pojasnite vrstni red branja in relativne poudarke, da se naslov, pripis in oznaka diagrama ne zamenjajo. Pred uporabo slike v objavi preverite pravopis, ločila in povezavo med oznako ter prikazanim elementom. Ustvarjalne nastavitve vključujejo razmerje stranic in ločljivost. Predstavitev poleg možnosti 1K, 2K in 4K dodaja izhod s 512 slikovnimi pikami ter razmerja stranic 4:1, 1:4, 8:1 in 1:8. Vodnik za razvijalce določa minimal kot privzeto raven razmišljanja in high kot možnost za zahtevnejše kompozicije. Pred kompozicijo izberite predvideno uporabo: pokončna zgodba, široka pasica in strnjen diagram potrebujejo različen prostor za motiv in morebitno besedilo. Te nastavitve opisujejo proizvajalčev postopek ustvarjanja za to linijo, ne samodejnega spreminjanja velikosti že dokončanega izdelka. Za doslednost motivov označite vlogo vsake reference: videz izdelka, identiteta lika, ozadje ali vizualni slog. Navedite podrobnosti, ki jih je treba ohraniti, nato pa elemente, ki jih je treba spremeniti. Izvirna naloga lahko priloženo fotografijo izdelka umesti v nov prizor ter ohrani njegovo obliko, material in vidne oznake znamke. Pri ilustriranem zaporedju ohranite iste reference in določite, katere podrobnosti se med prizori spreminjajo. Več referenc ne nadomesti jasnega navodila, kaj prispeva vsaka slika. Urejanje skozi pogovor je uporabno za konkretno spremembo. Zahtevajte prilagoditev enega predmeta, ozadja ali osvetlitve ob ohranitvi sprejete kompozicije. Proizvajalčev vodnik opisuje semantično maskiranje, pri katerem je urejano območje opredeljeno z besedami. Pri delu v več izmenjavah ohranite pogovor in zahtevane metapodatke konteksta sklepanja v izbranem vmesniku; vodnik Gemini 3 pojasnjuje, da podpisi razmišljanja pomagajo prenašati ta kontekst. Opis nespremenjenega območja je navodilo, ki ga je treba preveriti glede na izvirnik, ne jamstvo, da vsaka slikovna pika ostane enaka. Preglednica za razvijalce Gemini 3 izrecno navaja gemini-3.1-flash-image-preview z vhodnim obsegom 128K in izhodnim obsegom 32K. Pri beleženju ustvarjanja ohranite natančno ime modela Preview. Razpoložljive nastavitve referenc, izhoda in ločljivosti hranite skupaj z izvornimi slikami in zahtevo, da je spremembo mogoče dosledno ponoviti. Pri spremembi ohranite iste izvorne reference in določite natančno vizualno spremembo ter obdržite sprejeto vlogo vsakega vhoda. Vodnik za slike opozarja, da zahtevano število slik morda ne bo vedno upoštevano, in navaja označevanje ustvarjenih slik s SynthID. Preverite vse vrnjene slike in morebitno spremljevalno besedilo, namesto da bi domnevali, da je rezultat ena določena slika. Pri predvideni velikosti prikaza preverite identiteto motiva, število predmetov, besedilo v sliki, kompozicijo in zvestobo referencam. Pri zahtevnem prizoru navedite sestavne dele v logičnem vrstnem redu in želeni videz opišite s pozitivnimi navodili. Uporaben rezultat je pregledan vizualni izdelek, pri katerem so za naslednje urejanje ohranjene izvorne reference in natančna identiteta modela. Praktična naloga ### Praktična naloga Tehnični primer v angleščini ``` 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. ``` #### Pričakovani rezultat ``` An image with four distinct growing stages in the specified order and a consistent illustration style. ``` #### Preverjanje rezultata ``` 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/sl/#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` ### Začetek Nano Banana 2 (Gemini 3.1 Flash Image Preview) ustvarja in ureja slike iz besedila in vizualnih referenc. Njegove dokumentirane prednosti vključujejo doslednost motivov, besedilo v sliki in lokalizacijo, spremembe skozi pogovor ter ustvarjalni nadzor nad kompozicijo, razmerjem stranic in ločljivostjo. Dovoljeni vhodi Besedilo Rezultati Besedilo ### Na voljo v Ailoot · vhodi in metode **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Vhod `text` Izhod `text` Izhodni format json ali SSE | Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto | | --- | --- | --- | --- | --- | | Polje`model` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-flash-image-preview | Privzeto— | | Polje`messages` | Vrsta`message[]` | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 | Privzeto— | | Polje`messages[].role` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve Primeri: system, user, assistant, tool, function Pogoji: Te vloge so izrecno predstavljene s tipi združljivosti v izvorni kodi; natančen nabor vlog ostaja odvisen od modela. Odvisno od modela | Privzeto— | | Polje`messages[].content` | Vrsta`string\|content_part[]\|null` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— | | Polje`messages[].tool_calls` | Vrsta`tool_call[]` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— | | Polje`messages[].tool_call_id` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: role=tool; uporabite dejansko vrnjeni ID | Privzeto— | | Polje`messages[].name` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— | | Polje`messages[].reasoning_content` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: Pošljite nazaj dejansko vrnjeno sklepanje, kadar ga ta model uporablja | Privzeto— | | Polje`messages[].reasoning_details` | Vrsta`object\|array` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`max_tokens` | Vrsta`integer` | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— | | Polje`max_completion_tokens` | Vrsta`integer` | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— | | Polje`stream` | Vrsta`boolean` | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse | | Polje`stream_options.include_usage` | Vrsta`boolean` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`temperature` | Vrsta`number` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`top_p` | Vrsta`number` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`stop` | Vrsta`string\|string[]` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`tools` | Vrsta`function_tool[]` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`tools[].type` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve function Odvisno od modela | Privzeto— | | Polje`tools[].function.name` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: podano je funkcijsko orodje | Privzeto— | | Polje`tools[].function.description` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— | | Polje`tools[].function.parameters` | Vrsta`JSON_schema` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— | | Polje`tool_choice` | Vrsta`string\|object` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`parallel_tool_calls` | Vrsta`boolean` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`response_format` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`reasoning_effort` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`reasoning` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`service_tier` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`instructions` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Polje združljivosti | Privzeto— | | Polje`functions` | Vrsta`function[]` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`function_call` | Vrsta`string\|object` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`prompt_cache_options` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— | | Polje`modalities` | Vrsta`string[]` | ZahtevaIzbirno | Vrednosti in omejitve text | Privzeto— | | Polje`provider` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: provider.options je na tej besedilni poti Ultra zavrnjen | Privzeto— | | Polje`cache_control.ttl` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: 1h je zavrnjen na dejanskih mestih za predpomnjenje pozivov | Privzeto— | Kombinacije vhodnih gradiv **Besedilo** · Besedilo UTF8 `messages[].content` Parametri in življenjski cikel metode | Parameter | Specifikacija | | --- | --- | | Parameter`content_type` | Specifikacijaapplication/json | | Parameter`required` | Specifikacijamodel, messages | | Parameter`material_types` | Specifikacijatext | | Parameter`messages` | Specifikacijapolje sporočil s strukturo role/content | | Parameter`file_material` | Specifikacijadejanski dokument UTF-8 je vstavljen kot dobesedno besedilo; ID datoteke se ne izpeljuje | | Parameter`optional_controls` | Specifikacijastream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parameter`control_scope` | Specifikacijaodvisno od modela; uporabniška funkcijska orodja se razlikujejo od orodij, ki jih izvaja storitev | | Parameter`output_modalities` | Specifikacijatext | | Parameter`hosted_operations` | Specifikacijafalse | | Parameter`multimodal_input_binding` | Specifikacijanull | Življenjski cikel: `synchronous_or_streamed` Pošljite natančen ID modela skupaj z messages. Dolžina konteksta ni zgornja meja izhoda. Besedilna datoteka lahko poda dobesedno besedilo; slikovni, zvočni vhodi in vhodi z datotečnimi objekti potrebujejo natančno vezavo. ### Cenik Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi. Hitri način Standardna tarifa Ko je izbran hitri način Način flex Standardna tarifa Ko je izbran način flex Najvišja raven razmišljanja Standardna tarifa Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default) Raven razmišljanja · visoka Standardna tarifa Ko je raven razmišljanja visoka Raven razmišljanja · minimalna Standardna tarifa Ko je raven razmišljanja minimalna Cene izrecnega predpomnjenja Ni omogočeno Ko je zahtevano eksplicitno predpomnjenje #### Cene Ailoot #### Cene po nastavitvah Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno. | Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek | | --- | --- | --- | --- | --- | | NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni **$0.001** / 1K žetonov Izhod · Izhodni žetoni **$0.006** / 1K žetonov Vhod · Branje predpomnilnika **—** / 1K žetonov Vhod · Zapis v predpomnilnik **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura **—** / 1K žetonov Izhod · Izhodni žetoni slike **$0.12** / 1K slikovnih žetonov | | NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni **$0.001** / 1K žetonov Izhod · Izhodni žetoni **$0.006** / 1K žetonov Vhod · Branje predpomnilnika **—** / 1K žetonov Vhod · Zapis v predpomnilnik **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura **—** / 1K žetonov | #### Podrobnosti referenčne tarife Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot. google/gemini-3.1-flash-image-preview #### Cene po nastavitvah | Nastavitev | Obračunski pogoji | Strošek | | --- | --- | --- | | Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod **0,001 $** / 1K žetonov Izhod · Izhod **0,12 $** / 1K žetonov | google/gemini-3.1-flash-image-preview #### Cene po nastavitvah | Nastavitev | Obračunski pogoji | Strošek | | --- | --- | --- | | Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod **0,001 $** / 1K žetonov Izhod · Izhod **0,12 $** / 1K žetonov | google/gemini-3.1-flash-image-preview #### Cene po nastavitvah | Nastavitev | Obračunski pogoji | Strošek | | --- | --- | --- | | Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod **0,00 $** na klic Izhod · Izhod **0,16 $** na klic | google/gemini-3.1-flash-image-preview #### Cene po nastavitvah | Nastavitev | Obračunski pogoji | Strošek | | --- | --- | --- | | Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod **0,00 $** na klic Izhod · Izhod **0,32 $** na klic | google/gemini-3.1-flash-image-preview #### Cene po nastavitvah | Nastavitev | Obračunski pogoji | Strošek | | --- | --- | --- | | Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod **0,00 $** na klic Izhod · Izhod **0,00 $** na klic | Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) #### Cene po nastavitvah | Nastavitev | Obračunski pogoji | Strošek | | --- | --- | --- | | NastavitevGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhodni žetoni **0,001 $** / 1K žetonov Izhod · Izhodni žetoni **0,006 $** / 1K žetonov Izhod · Izhodna slika **0,12 $** / 1K žetonov Izhod · Iskanje po spletu **0,028 $** na iskanje | Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. [Kako delujeta rezervacija in obračun →](https://ailoot.ai/docs/sl/billing/reserve/) ### Primeri zahtev #### Ailoot Ultra · OpenAI Chat curlPython SDKTok Python ```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") ``` ### Prejmi in shrani rezultate #### Ailoot Ultra · OpenAI Chat json ali SSE ##### Ohrani vse dokončane rezultate Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine. Ohranite vsako možnost odgovora ter njeno vsebino, klice orodij in sklepanje. V SSE sestavite delne spremembe po indeksu možnosti/orodja ter ohranite končni razlog zaključka in podatke o porabi. ##### Če je treba preveriti izvirni odgovor Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan. Polja odgovora | Polje | Vrsta | | --- | --- | | Polje`choices[].index` | Vrstainteger | | Polje`choices[].message.content` | Vrstastring\|null | | Polje`choices[].message.tool_calls` | Vrstatool\_call\[\] | | Polje`choices[].message.reasoning_content` | Vrstastring | | Polje`choices[].message.reasoning_details` | Vrstaobject\|array | | Polje`choices[].finish_reason` | Vrstastring\|null | | Polje`usage` | Vrstaobject | Napake in naslednji koraki | Odgovor | Pogoj | Naslednji korak | | --- | --- | --- | | Odgovor400 · `invalid_request_error` | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. | ### Druga imena #### Druga imena modelov **Ailoot Ultra** [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/sl/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) #### Druga imena poti metod `/v1/images` #### Povezani ID-ji za klic [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/sl/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) **Ailoot Ultra · Slike** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/sl/#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` ### Začetek Nano Banana 2 (Gemini 3.1 Flash Image Preview) ustvarja in ureja slike iz besedila in vizualnih referenc. Njegove dokumentirane prednosti vključujejo doslednost motivov, besedilo v sliki in lokalizacijo, spremembe skozi pogovor ter ustvarjalni nadzor nad kompozicijo, razmerjem stranic in ločljivostjo. Dovoljeni vhodi Besedilo · Slike Rezultati Slike ### Na voljo v Ailoot · vhodi in metode **Ailoot Ultra · Slike** `POST /v1/images/generations` Vhod `text`, `image` Izhod `image` | Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto | | --- | --- | --- | --- | --- | | Polje`model` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-flash-image-preview | Privzeto— | | Polje`prompt` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— | | Polje`resolution` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 512, 1K, 2K, 4K | Privzeto— | | Polje`aspect_ratio` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 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 | Privzeto— | | Polje`n` | Vrsta`integer` | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1 | Privzeto— | | Polje`input_references` | Vrsta`array` | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 14 | Privzeto— | | Polje`provider` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— | Parametri in življenjski cikel metode | Parameter | Specifikacija | | --- | --- | | Parameter`content_type` | Specifikacijaapplication/json | | Parameter`required` | Specifikacijamodel, prompt | | Parameter`material_types` | Specifikacijatext, image | Življenjski cikel: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · Dejansko vrnjeni task\_id ali zapis v medijski knjižnici `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Cenik ##### Kako se izračuna končni strošek Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina. Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi. Hitri način Ni navedeno Ko je izbran hitri način Način flex Ni navedeno Ko je izbran način flex Najvišja raven razmišljanja Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default) #### Ocenjene cene za primerjavo #### Cene po nastavitvah Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno. | Nastavitev | Cenovna lestvica | Predvidena količina | Strošek | | --- | --- | --- | --- | | NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo **—** / 1K žetonov | | NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo **$0.49152** ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. | Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. [Kako delujeta rezervacija in obračun →](https://ailoot.ai/docs/sl/billing/reserve/) ### Primeri zahtev #### Ailoot Ultra · Slike 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"