Nano Banana Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
", "aboutText": "Nano Banana Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.\n\nModel podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.\n\nIzris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.\n\nVhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.\n\nUtemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.\n\nSklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.\n\nKartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.\n\nTrenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.\n\nPraktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.", "editorialOverlay": { "copy_fields": { "practical_html": "Tehnični primer v angleščini
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) je Googlov slikovni model, ki uporablja sklepanje za zahtevno oblikovanje, makete izdelkov in vizualizacije dejanskih podatkov. Sprejema besedilo in slikovne reference ter ustvarja slike z besedilom, z izhodom 1K–4K in podrobnim ustvarjalnim nadzorom.
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 Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve gemini-3-pro-image | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 | Privzeto1 |
Poljeresponse_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve url, b64_json | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljequality | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljebackground | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeoutput_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeoutput_compression | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemoderation | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeinput_fidelity | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljestyle | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljepartial_images | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Iz besedila v sliko · Obvezno: prompt
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional_controls | Specifikacijanull |
Parametercontent_type | Specifikacijaapplication/json |
Ž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}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/images/generationsAiloot 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 →
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
| Nastavitev | Cenovna lestvica | Strošek |
|---|---|---|
| NastavitevUltra | Cenovna lestvicaOsnovna cena | Strošek Vhod · Vhodni žetoni $0.004000 / 1K žetonov Izhod · Izhodni žetoni $0.024000 / 1K žetonov Vhod · slika $0.004000 / 1K žetonov Izhod · izhod slike $0.24000 / 1K žetonov Vhod · zvok $0.004000 / 1K žetonov Vhod · predpomnilnik vhodnega zvoka $0.0004000 / 1K žetonov Izhod · iskanje po spletu $0.028 na spletno iskanje Izhod · notranje razmišljanje $0.024000 / 1K žetonov Vhod · Branje predpomnilnika $0.0004000 / 1K žetonov Vhod · Zapis v predpomnilnik $0.000750000 / 1K žetonov |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3-pro-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3-pro-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3-pro-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.
Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrstainteger |
Poljedata[].url | Vrstastring |
Poljedata[].b64_json | Vrstabase64 string |
Poljeusage | Vrstaobject |
| 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. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
gemini-3-pro-image-previewNano Banana Pro (Gemini 3 Pro Image) je Googlov slikovni model, ki uporablja sklepanje za zahtevno oblikovanje, makete izdelkov in vizualizacije dejanskih podatkov. Sprejema besedilo in slikovne reference ter ustvarja slike z besedilom, z izhodom 1K–4K in podrobnim ustvarjalnim nadzorom.
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 Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve gemini-3-pro-image-preview | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 | Privzeto1 |
Poljeresponse_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve url, b64_json | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljequality | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljebackground | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeoutput_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeoutput_compression | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemoderation | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeinput_fidelity | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljestyle | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljepartial_images | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Iz besedila v sliko · Obvezno: prompt
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional_controls | Specifikacijanull |
Parametercontent_type | Specifikacijaapplication/json |
Ž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}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/images/generationsAiloot 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 →
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
| Nastavitev | Cenovna lestvica | Strošek |
|---|---|---|
| NastavitevUltra | Cenovna lestvicaOsnovna cena | Strošek Vhod · Vhodni žetoni $0.004000 / 1K žetonov Izhod · Izhodni žetoni $0.024000 / 1K žetonov Vhod · slika $0.004000 / 1K žetonov Izhod · izhod slike $0.24000 / 1K žetonov Vhod · zvok $0.004000 / 1K žetonov Vhod · predpomnilnik vhodnega zvoka $0.0004000 / 1K žetonov Izhod · iskanje po spletu $0.028 na spletno iskanje Izhod · notranje razmišljanje $0.024000 / 1K žetonov Vhod · Branje predpomnilnika $0.0004000 / 1K žetonov Vhod · Zapis v predpomnilnik $0.000750000 / 1K žetonov |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3-pro-image-preview", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3-pro-image-preview', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3-pro-image-preview", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.
Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrstainteger |
Poljedata[].url | Vrstastring |
Poljedata[].b64_json | Vrstabase64 string |
Poljeusage | Vrstaobject |
| 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. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
nano-banana-proNano Banana Pro (Gemini 3 Pro Image) je Googlov slikovni model, ki uporablja sklepanje za zahtevno oblikovanje, makete izdelkov in vizualizacije dejanskih podatkov. Sprejema besedilo in slikovne reference ter ustvarja slike z besedilom, z izhodom 1K–4K in podrobnim ustvarjalnim nadzorom.
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 Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve nano-banana-pro | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 | Privzeto1 |
Poljeresponse_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve url, b64_json | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljequality | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljebackground | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeoutput_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeoutput_compression | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemoderation | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeinput_fidelity | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljestyle | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljepartial_images | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Iz besedila v sliko · Obvezno: prompt
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional_controls | Specifikacijanull |
Parametercontent_type | Specifikacijaapplication/json |
Ž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}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/images/generationsAiloot 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 →
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
| Nastavitev | Cenovna lestvica | Strošek |
|---|---|---|
| NastavitevUltra | Cenovna lestvicaOsnovna cena | Strošek Vhod · Vhodni žetoni $0.004000 / 1K žetonov Izhod · Izhodni žetoni $0.024000 / 1K žetonov Vhod · slika $0.004000 / 1K žetonov Izhod · izhod slike $0.24000 / 1K žetonov Vhod · zvok $0.004000 / 1K žetonov Vhod · predpomnilnik vhodnega zvoka $0.0004000 / 1K žetonov Izhod · iskanje po spletu $0.028 na spletno iskanje Izhod · notranje razmišljanje $0.024000 / 1K žetonov Vhod · Branje predpomnilnika $0.0004000 / 1K žetonov Vhod · Zapis v predpomnilnik $0.000750000 / 1K žetonov |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "nano-banana-pro", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'nano-banana-pro', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "nano-banana-pro", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.
Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrstainteger |
Poljedata[].url | Vrstastring |
Poljedata[].b64_json | Vrstabase64 string |
Poljeusage | Vrstaobject |
| 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. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) je Googlov slikovni model, ki uporablja sklepanje za zahtevno oblikovanje, makete izdelkov in vizualizacije dejanskih podatkov. Sprejema besedilo in slikovne reference ter ustvarja slike z besedilom, z izhodom 1K–4K in podrobnim ustvarjalnim nadzorom.
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 Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
POST /v1/chat/completionstexttext| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3-pro-image | Privzeto— |
Poljemessages | Vrstamessage[] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 | Privzeto— |
Poljemessages[].role | Vrstastring | 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— |
Poljemessages[].content | Vrstastring|content_part[]|null | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].tool_calls | Vrstatool_call[] | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].tool_call_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: role=tool; uporabite dejansko vrnjeni ID | Privzeto— |
Poljemessages[].name | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].reasoning_content | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: Pošljite nazaj dejansko vrnjeno sklepanje, kadar ga ta model uporablja | Privzeto— |
Poljemessages[].reasoning_details | Vrstaobject|array | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemax_tokens | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— |
Poljemax_completion_tokens | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljestream_options.include_usage | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetemperature | Vrstanumber | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetop_p | Vrstanumber | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljestop | Vrstastring|string[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetools | Vrstafunction_tool[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetools[].type | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve function Odvisno od modela | Privzeto— |
Poljetools[].function.name | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: podano je funkcijsko orodje | Privzeto— |
Poljetools[].function.description | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetools[].function.parameters | VrstaJSON_schema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetool_choice | Vrstastring|object | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeparallel_tool_calls | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeresponse_format | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljereasoning_effort | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljereasoning | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeservice_tier | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeinstructions | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Polje združljivosti | Privzeto— |
Poljefunctions | Vrstafunction[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljefunction_call | Vrstastring|object | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeprompt_cache_options | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemodalities | Vrstastring[] | ZahtevaIzbirno | Vrednosti in omejitve text | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: provider.options je na tej besedilni poti Ultra zavrnjen | Privzeto— |
Poljecache_control.ttl | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: 1h je zavrnjen na dejanskih mestih za predpomnjenje pozivov | Privzeto— |
Besedilo · Besedilo UTF8
messages[].content
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, messages |
Parametermaterial_types | Specifikacijatext |
Parametermessages | Specifikacijapolje sporočil s strukturo role/content |
Parameterfile_material | Specifikacijadejanski dokument UTF-8 je vstavljen kot dobesedno besedilo; ID datoteke se ne izpeljuje |
Parameteroptional_controls | Specifikacijastream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Specifikacijaodvisno od modela; uporabniška funkcijska orodja se razlikujejo od orodij, ki jih izvaja storitev |
Parameteroutput_modalities | Specifikacijatext |
Parameterhosted_operations | Specifikacijafalse |
Parametermultimodal_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.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
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.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov Izhod · Izhodni žetoni slike $0.24 / 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.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| NastavitevGoogle: Nano Banana Pro (Gemini 3 Pro Image) · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhodni žetoni 0,004 $ / 1K žetonov Izhod · Izhodni žetoni 0,024 $ / 1K žetonov Vhod · Vhodna slika 0,004 $ / 1K žetonov Izhod · Izhodna slika 0,24 $ / 1K žetonov Vhod · Zvočni vhod 0,004 $ / 1K žetonov Vhod · Branje zvoka iz predpomnilnika 0,0004 $ / 1K žetonov Izhod · Iskanje po spletu 0,028 $ na iskanje Izhod · Žetoni razmišljanja 0,024 $ / 1K žetonov Vhod · Branje predpomnilnika 0,0004 $ / 1K žetonov Vhod · Zapis v predpomnilnik · 5 minut 0,00075 $ / 1K žetonov |
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-3-pro-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-3-pro-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='google/gemini-3-pro-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson ali SSE
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.
Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan.
| Polje | Vrsta |
|---|---|
Poljechoices[].index | Vrstainteger |
Poljechoices[].message.content | Vrstastring|null |
Poljechoices[].message.tool_calls | Vrstatool_call[] |
Poljechoices[].message.reasoning_content | Vrstastring |
Poljechoices[].message.reasoning_details | Vrstaobject|array |
Poljechoices[].finish_reason | Vrstastring|null |
Poljeusage | Vrstaobject |
| 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. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) je Googlov slikovni model, ki uporablja sklepanje za zahtevno oblikovanje, makete izdelkov in vizualizacije dejanskih podatkov. Sprejema besedilo in slikovne reference ter ustvarja slike z besedilom, z izhodom 1K–4K in podrobnim ustvarjalnim nadzorom.
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 Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
POST /v1/images/generationstext, imageimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3-pro-image | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1K, 2K, 4K | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1 | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 14 | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parametermaterial_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}
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.
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.98304 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'google/gemini-3-pro-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nShranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.
Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrsta |
Poljedata[].url | Vrsta |
Poljedata[].b64_json | Vrsta |
Poljeusage | Vrsta |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) je Googlov slikovni model, ki uporablja sklepanje za zahtevno oblikovanje, makete izdelkov in vizualizacije dejanskih podatkov. Sprejema besedilo in slikovne reference ter ustvarja slike z besedilom, z izhodom 1K–4K in podrobnim ustvarjalnim nadzorom.
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 Pro je Googlov model Gemini 3 Pro Image za ustvarjanje in urejanje slik, podprto s sklepanjem. Proizvajalec v središče njegove predvidene uporabe postavlja zahtevno grafično oblikovanje, zelo zveste makete izdelkov in vizualizacijo dejanskih podatkov. Sprejema besedilo in slike ter ustvarja sliko in besedilo. Ta poimenovana slikovna izdaja Pro temelji na Gemini 3 Pro, pri tem pa ohranja lasten vhodni profil in profil zmožnosti za slikovne naloge.
Model podpira slike 1K, 2K in 4K. Dokumentirane oblike vključujejo 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 in 21:9. Kvadratna slika 4K meri 4096 × 4096; slika 4K z razmerjem 16:9 meri 5504 × 3072. Ločljivost in razmerje stranic izberite za izdelek, ki ga potrebujete, naj bo to pokončen plakat, prizor z izdelkom ali široka pojasnjevalna grafika. Možnost 0.5K in dodatna skrajna razmerja Gemini 3.1 Flash Image niso del te preglednice Pro.
Izris besedila podpira jasne črke na plakatih, diagramih in drugih oblikovanih izdelkih. Pri zahtevni infografiki priložite osnovna dejstva, natančno ubeseditev, zaporedje branja in razmerja med oznakami ter vizualnimi elementi. Informacije, ki jih je treba sporočiti, ločite od želenega umetniškega sloga. Google priporoča, da najprej pripravite besedilo in nato ustvarite sliko, ki ga vsebuje. To je posebej uporabno, kadar kompozicija združuje naslov, diagram in več kratkih pripisov.
Vhod z več slikami podpira do 14 referenc. Googlova preglednica funkcij opisuje največ šest referenc predmetov za zvestobo, največ pet referenc likov za doslednost in največ tri slogovne reference. Te vloge pomagajo pripraviti sestavljen vizualni prikaz: fotografija izdelka določa videz, ločena slika vzpostavlja okolje, slogovna slika pa usmerja obdelavo. Modelu povejte, katere podrobnosti so merodajne in katere reference dajejo navdih, namesto da bi zahtevali neselektivno združevanje vseh vidnih značilnosti.
Utemeljevanje z Google Search lahko zagotovi informacije iz resničnega sveta za vizualizacijo dejanskih podatkov ali prizor, ki upošteva aktualne razmere. Delovni postopek Pro za slike dokumentira spletno utemeljevanje; razširitev Image Search je dokumentirana posebej za Nano Banana 2.1 in Gemini 3.1 Flash Image. Pri podatkovni grafiki priložite vrednosti, ki jih želite prikazati, ali v proizvajalčevem postopku zahtevajte informacije, utemeljene z viri, nato pa izrecno opredelite razmerja, oznake in postavitev. Ustvarjanje ob pomoči iskanja še vedno ustvari sliko, ki jo je treba pregledati, in ne nadomesti preverjanja prikazanih dejstev.
Sklepanje podpira sestavljanje zahtevnega poziva pred končnim izrisom. Vodnik za slike opisuje vmesne slike za preverjanje kompozicije in logike, ki se razlikujejo od končnega izdelka. Na to izdajo Pro ne prenašajte preglednice nastavitev minimal/high iz Nano Banana 2 ali preglednice s privzeto ravnjo medium iz Nano Banana 2.1. Pri zahtevnem oblikovanju podajte popolna navodila z vizualno hierarhijo, zahtevanimi razmerji med predmeti in elementi, ki morajo ostati ohranjeni pri poznejšem urejanju.
Kartica modela opisuje pomembne preostale omejitve: zelo majhno besedilo in dolgi odlomki so lahko izrisani slabo, videz lika se lahko med referenco in rezultatom spremeni, urejanje z maskami ali skicami pa lahko navodilu sledi le delno ali pusti sledi. Model lahko tudi zamenja levo in desno ali kopira izvorni element v novo kompozicijo. Pri spremembi izdelka izrecno navedite geometrijo in oznake, ki jih je treba ohraniti, ter preglejte urejeno območje; pri diagramu primerjajte smer puščic in relativne položaje predmetov.
Trenutna preglednica API navaja vhodno omejitev 65,536 žetonov in izhodno omejitev 32,768 žetonov. Podprti so ustvarjanje slik, razmišljanje, utemeljevanje z iskanjem in paketna obdelava; ustvarjanje zvoka, klicanje funkcij, izvajanje kode, predpomnjenje, strukturirani izhodi, iskanje po datotekah, kontekst URL in Live API niso podprti. Slikovna naloga v tem profilu ne sprejema niti zvočnega niti video vhoda. Ustvarjene slike vključujejo SynthID, zahtevano število izhodnih slik pa ni vedno natančno upoštevano.
Praktična navodila za izdelek lahko združujejo sliko izdelka, referenco osvetlitve in natančen naslov: »Ohrani razmerja izdelka in njegov napis, prikaži ga na bledi kamniti površini pod mehko stransko svetlobo ter pusti zgornjo tretjino prazno za priloženi naslov.« Pri diagramu dejanskih podatkov opredelite vsako entiteto in povezavo ter priložite potrjene oznake. Rezultat izpopolnjujte v pogovoru tako, da navedete eno spremembo in značilnosti, ki jih je treba ohraniti, izbrano sliko in njeno pojasnjevalno besedilo pa hranite skupaj kot oblikovalski izdelek.
POST /v1/messagestextjson, sse| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3-pro-image | Privzeto— |
Poljemessages | Vrstamessage[] | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].role | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve user, assistant | Privzeto— |
Poljemessages[].content | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljemax_tokens | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Besedilo · Besedilo UTF-8
niz messages[].content
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, messages, max_tokens |
Parameteroptional_controls | Specifikacijastream |
Parametermaterial_types | Specifikacijatext |
Parametertext_file_material | SpecifikacijaPreberite dejanski dokument UTF-8 in njegovo besedilo vstavite v navedeni vhodni niz ali niz vsebine sporočila. |
Življenjski cikel: synchronous_or_streamed
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
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.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov Izhod · Izhodni žetoni slike $0.24 / 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.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
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 →
{\n "model": "google/gemini-3-pro-image",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3-pro-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3-pro-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON ali SSE
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohranite vse vsebinske bloke, podpise sklepanja in dejanske ID uporabe orodij. Sestavite vse delne spremembe blokov SSE; prvi besedilni blok ni celoten izhod.
Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan.
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljemodel | Vrstastring |
Poljecontent[] | Vrstatext|thinking|tool_use|other content block |
Poljestop_reason | Vrstastring|null |
Poljeusage | Vrstaobject |
| 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. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
Tehnični primer v angleščini
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.