Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
", "aboutText": "Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.\n\nHet model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.\n\nTekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.\n\nInvoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.\n\nGoogle Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.\n\nRedeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.\n\nDe modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.\n\nDe huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.\n\nEen praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.", "editorialOverlay": { "copy_fields": { "practical_html": "Technisch voorbeeld in het Engels
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) is Googles door redeneren gestuurd beeldmodel voor complex ontwerp, productmock-ups en feitelijke visualisaties. Het accepteert tekst en beeldreferenties en genereert beelden met tekst, met uitvoer in 1K–4K en gedetailleerde creatieve instellingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gemini-3-pro-image | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmoderation | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldinput_fidelity | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldstyle | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Tekst naar afbeelding · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Tariefstaffel | Kosten |
|---|---|---|
| ConfiguratieUltra | TariefstaffelBasistarief | Kosten Invoer · Invoertokens $0.004000 / 1K tokens Uitvoer · Uitvoertokens $0.024000 / 1K tokens Invoer · afbeelding $0.004000 / 1K tokens Uitvoer · afbeeldingsuitvoer $0.24000 / 1K tokens Invoer · audio $0.004000 / 1K tokens Invoer · cache voor audio-invoer $0.0004000 / 1K tokens Uitvoer · zoeken op het web $0.028 per webzoekopdracht Uitvoer · intern redeneren $0.024000 / 1K tokens Invoer · Cache lezen $0.0004000 / 1K tokens Invoer · Cache schrijven $0.000750000 / 1K tokens |
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk data-item op. Decodeer elke b64_json of haal elk bestand op via elke geretourneerde ondertekende URL. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de geretourneerde resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met de daadwerkelijke task_id- of asset_id-waarden. Dien de generatie-/bewerkingsaanvraag niet opnieuw in en bouw geen polling-URL op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
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) is Googles door redeneren gestuurd beeldmodel voor complex ontwerp, productmock-ups en feitelijke visualisaties. Het accepteert tekst en beeldreferenties en genereert beelden met tekst, met uitvoer in 1K–4K en gedetailleerde creatieve instellingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gemini-3-pro-image-preview | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmoderation | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldinput_fidelity | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldstyle | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Tekst naar afbeelding · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Tariefstaffel | Kosten |
|---|---|---|
| ConfiguratieUltra | TariefstaffelBasistarief | Kosten Invoer · Invoertokens $0.004000 / 1K tokens Uitvoer · Uitvoertokens $0.024000 / 1K tokens Invoer · afbeelding $0.004000 / 1K tokens Uitvoer · afbeeldingsuitvoer $0.24000 / 1K tokens Invoer · audio $0.004000 / 1K tokens Invoer · cache voor audio-invoer $0.0004000 / 1K tokens Uitvoer · zoeken op het web $0.028 per webzoekopdracht Uitvoer · intern redeneren $0.024000 / 1K tokens Invoer · Cache lezen $0.0004000 / 1K tokens Invoer · Cache schrijven $0.000750000 / 1K tokens |
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk data-item op. Decodeer elke b64_json of haal elk bestand op via elke geretourneerde ondertekende URL. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de geretourneerde resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met de daadwerkelijke task_id- of asset_id-waarden. Dien de generatie-/bewerkingsaanvraag niet opnieuw in en bouw geen polling-URL op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
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) is Googles door redeneren gestuurd beeldmodel voor complex ontwerp, productmock-ups en feitelijke visualisaties. Het accepteert tekst en beeldreferenties en genereert beelden met tekst, met uitvoer in 1K–4K en gedetailleerde creatieve instellingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten nano-banana-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmoderation | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldinput_fidelity | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldstyle | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Tekst naar afbeelding · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Tariefstaffel | Kosten |
|---|---|---|
| ConfiguratieUltra | TariefstaffelBasistarief | Kosten Invoer · Invoertokens $0.004000 / 1K tokens Uitvoer · Uitvoertokens $0.024000 / 1K tokens Invoer · afbeelding $0.004000 / 1K tokens Uitvoer · afbeeldingsuitvoer $0.24000 / 1K tokens Invoer · audio $0.004000 / 1K tokens Invoer · cache voor audio-invoer $0.0004000 / 1K tokens Uitvoer · zoeken op het web $0.028 per webzoekopdracht Uitvoer · intern redeneren $0.024000 / 1K tokens Invoer · Cache lezen $0.0004000 / 1K tokens Invoer · Cache schrijven $0.000750000 / 1K tokens |
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk data-item op. Decodeer elke b64_json of haal elk bestand op via elke geretourneerde ondertekende URL. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de geretourneerde resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met de daadwerkelijke task_id- of asset_id-waarden. Dien de generatie-/bewerkingsaanvraag niet opnieuw in en bouw geen polling-URL op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
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) is Googles door redeneren gestuurd beeldmodel voor complex ontwerp, productmock-ups en feitelijke visualisaties. Het accepteert tekst en beeldreferenties en genereert beelden met tekst, met uitvoer in 1K–4K en gedetailleerde creatieve instellingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
POST /v1/chat/completionstexttext| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3-pro-image | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten Voorbeelden: system, user, assistant, tool, function Voorwaarden: Deze rollen worden expliciet weergegeven door compatibiliteitstypen in de broncode; de exacte rollenverzameling van het model blijft modelspecifiek. Afhankelijk van het model | Standaard— |
Veldmessages[].content | Typestring|content_part[]|null | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldmessages[].tool_calls | Typetool_call[] | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldmessages[].tool_call_id | Typestring | VereisteOptioneel | Waarden en limieten Geldt wanneer: role=tool; gebruik het werkelijk teruggegeven ID | Standaard— |
Veldmessages[].name | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldmessages[].reasoning_content | Typestring | VereisteOptioneel | Waarden en limieten Geldt wanneer: Stuur de werkelijk teruggegeven redeneringen terug wanneer dit model ze gebruikt | Standaard— |
Veldmessages[].reasoning_details | Typeobject|array | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmax_tokens | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Afhankelijk van het model | Standaard— |
Veldmax_completion_tokens | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Afhankelijk van het model | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldstream_options.include_usage | Typeboolean | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtemperature | Typenumber | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtop_p | Typenumber | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldstop | Typestring|string[] | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtools | Typefunction_tool[] | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtools[].type | Typestring | VereisteOptioneel | Waarden en limieten function Afhankelijk van het model | Standaard— |
Veldtools[].function.name | Typestring | VereisteVereist | Waarden en limieten Geldt wanneer: functietool opgegeven | Standaard— |
Veldtools[].function.description | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtools[].function.parameters | TypeJSON_schema | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtool_choice | Typestring|object | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldparallel_tool_calls | Typeboolean | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldresponse_format | Typeobject | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldreasoning_effort | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldreasoning | Typeobject | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldservice_tier | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldinstructions | Typestring | VereisteOptioneel | Waarden en limieten Compatibiliteitsveld | Standaard— |
Veldfunctions | Typefunction[] | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldfunction_call | Typestring|object | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldprompt_cache_options | Typeobject | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmodalities | Typestring[] | VereisteOptioneel | Waarden en limieten text | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten Voorwaarden: provider.options wordt op deze Ultra-tekstroute geweigerd | Standaard— |
Veldcache_control.ttl | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: 1h wordt op de daadwerkelijke locaties voor promptcaching geweigerd | Standaard— |
Tekst · UTF8-tekst
messages[].content
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, messages |
Parametermaterial_types | Contracttext |
Parametermessages | Contractberichtenarray met de structuur role/content |
Parameterfile_material | Contractwerkelijk UTF-8-document ingevoegd als letterlijke tekst; er wordt geen bestands-ID afgeleid |
Parameteroptional_controls | Contractstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Contractmodelspecifiek; functietools van de gebruiker verschillen van gehoste tools |
Parameteroutput_modalities | Contracttext |
Parameterhosted_operations | Contractfalse |
Parametermultimodal_input_binding | Contractnull |
Levenscyclus: synchronous_or_streamed
Stuur het exacte model-ID mee met messages.
Contextlengte is geen uitvoerlimiet.
Een tekstbestand kan letterlijke tekst aanleveren; beeld-, audio- en bestandsobjectinvoer vereisen een exacte koppeling.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Contexttokens, meer dan | Contexttokens, tot en met | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Contexttokens, meer dan— | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.004 / 1K tokens Uitvoer · Uitvoertokens $0.024 / 1K tokens Invoer · Cache lezen $0.0004 / 1K tokens Invoer · Cache schrijven $0.00075 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens Uitvoer · Tokens voor afbeeldingsuitvoer $0.24 / 1K afbeeldingstokens |
| ConfiguratieNiveau 1 voor aanvraaglengte | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.004 / 1K tokens Uitvoer · Uitvoertokens $0.024 / 1K tokens Invoer · Cache lezen $0.0004 / 1K tokens Invoer · Cache schrijven $0.00075 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieGoogle: Nano Banana Pro (Gemini 3 Pro Image) · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoertokens US$ 0,004 / 1K tokens Uitvoer · Uitvoertokens US$ 0,024 / 1K tokens Invoer · Invoerafbeelding US$ 0,004 / 1K tokens Uitvoer · Uitvoerafbeelding US$ 0,24 / 1K tokens Invoer · Audio-invoer US$ 0,004 / 1K tokens Invoer · Lezen uit audiocache US$ 0,0004 / 1K tokens Uitvoer · Zoeken op het web US$ 0,028 per zoekopdracht Uitvoer · Redeneertokens US$ 0,024 / 1K tokens Invoer · Cache lezen US$ 0,0004 / 1K tokens Invoer · Schrijven naar cache · 5 minuten US$ 0,00075 / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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 of SSE
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar elke keuze en de bijbehorende inhoud, toolaanroepen en redeneringen. Voeg in SSE delta’s samen per keuze-/toolindex en bewaar de uiteindelijke reden van beëindiging en de verbruiksgegevens.
Bewaar aanvraag-/antwoord-ID’s en headers. Er wordt geen algemene URL meegeleverd om teksttaken op te halen.
| Veld | Type |
|---|---|
Veldchoices[].index | Typeinteger |
Veldchoices[].message.content | Typestring|null |
Veldchoices[].message.tool_calls | Typetool_call[] |
Veldchoices[].message.reasoning_content | Typestring |
Veldchoices[].message.reasoning_details | Typeobject|array |
Veldchoices[].finish_reason | Typestring|null |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
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) is Googles door redeneren gestuurd beeldmodel voor complex ontwerp, productmock-ups en feitelijke visualisaties. Het accepteert tekst en beeldreferenties en genereert beelden met tekst, met uitvoer in 1K–4K en gedetailleerde creatieve instellingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3-pro-image | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 1K, 2K, 4K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 14 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.98304 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
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.\nSla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
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) is Googles door redeneren gestuurd beeldmodel voor complex ontwerp, productmock-ups en feitelijke visualisaties. Het accepteert tekst en beeldreferenties en genereert beelden met tekst, met uitvoer in 1K–4K en gedetailleerde creatieve instellingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Nano Banana Pro is Googles model Gemini 3 Pro Image voor beeldgeneratie en bewerking op basis van redeneren. De fabrikant plaatst complex grafisch ontwerp, getrouwe productmock-ups en feitelijke gegevensvisualisatie centraal in het beoogde gebruik. Het accepteert tekst en beelden en produceert beeld en tekst. Deze benoemde Pro-beeldeditie is gebaseerd op Gemini 3 Pro en behoudt het eigen invoer- en capaciteitenprofiel voor beeldtaken.
Het model ondersteunt beelden in 1K, 2K en 4K. Gedocumenteerde vormen zijn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 en 21:9. Een vierkant 4K-beeld is 4096 × 4096; een 16:9-beeld in 4K is 5504 × 3072. Kies resolutie en beeldverhouding voor het resultaat dat u nodig hebt, zoals een staande poster, productscène of brede verklarende afbeelding. De optie 0.5K en extra extreme verhoudingen van Gemini 3.1 Flash Image maken geen deel uit van deze Pro-tabel.
Tekstweergave ondersteunt heldere belettering in posters, diagrammen en andere ontwerpen. Geef voor een complexe infographic de onderliggende feiten, exacte formuleringen, een leesvolgorde en de relatie tussen labels en visuele elementen. Scheid de informatie die moet worden overgebracht van de gewenste artistieke stijl. Google raadt aan eerst de tekst voor te bereiden en daarna het beeld met die tekst te genereren. Dat is vooral nuttig wanneer een compositie een kop, diagram en meerdere korte bijschriften combineert.
Invoer met meerdere beelden ondersteunt maximaal 14 referenties. Googles functietabel beschrijft maximaal zes objectreferenties voor getrouwheid, maximaal vijf personagereferenties voor consistentie en maximaal drie stijlreferenties. Deze rollen helpen een samengesteld beeld voorbereiden: een productfoto definieert het uiterlijk, een afzonderlijk beeld legt de omgeving vast en een stijlbeeld stuurt de behandeling. Vertel het model welke details gezaghebbend zijn en welke referenties inspiratie bieden in plaats van te vragen elk zichtbaar kenmerk zonder onderscheid te combineren.
Google Search-grounding kan informatie uit de werkelijke wereld leveren voor een feitelijke visualisatie of een scène die door actuele omstandigheden wordt gestuurd. De Pro-beeldwerkstroom documenteert webgrounding; de Image Search-uitbreiding is specifiek voor Nano Banana 2.1 en Gemini 3.1 Flash Image gedocumenteerd. Geef voor een gegevensgrafiek de waarden die u wilt tonen of vraag om informatie met grounding in de producentwerkstroom en maak daarna de relatie, labels en indeling expliciet. Zoekgestuurde generatie levert nog steeds een beeld om te beoordelen, geen vervanging voor het controleren van de afgebeelde feiten.
Redeneren ondersteunt het samenstellen van een complexe prompt vóór de uiteindelijke rendering. De beeldhandleiding beschrijft tussentijdse beelden om compositie en logica te testen, los van het eindresultaat. Neem de instellingentabel minimal/high van Nano Banana 2 of de tabel met medium als standaard van Nano Banana 2.1 niet over naar deze Pro-editie. Geef voor een veeleisend ontwerp een volledige briefing met de visuele hiërarchie, vereiste objectrelaties en de elementen die latere bewerkingen moeten doorstaan.
De modelkaart beschrijft wezenlijke resterende beperkingen: zeer kleine tekst en lange passages kunnen slecht worden weergegeven, het uiterlijk van personages kan tussen referentie en resultaat veranderen en bewerkingen met maskers of schetsen kunnen de instructie maar gedeeltelijk volgen of sporen achterlaten. Het kan ook links en rechts verwarren of een bronelement in de nieuwe compositie kopiëren. Benoem bij een productrevisie expliciet de behouden geometrie en labels en inspecteer het bewerkte gebied; vergelijk voor een diagram de pijlrichting en relatieve objectposities.
De huidige API-tabel geeft een invoerlimiet van 65.536 tokens en een uitvoerlimiet van 32.768 tokens. Beeldgeneratie, denken, zoekgrounding en batchverwerking worden ondersteund; audiogeneratie, functieaanroepen, code-uitvoering, caching, gestructureerde uitvoer, zoeken in bestanden, URL-context en Live API niet. De beeldtaak accepteert in dit profiel geen audio- of video-invoer. Gegenereerde beelden bevatten SynthID en een gevraagd aantal uitvoerbeelden wordt niet altijd exact gevolgd.
Een praktische productbriefing kan een productbeeld, een belichtingsreferentie en de exacte kop combineren: “Behoud de verhoudingen en belettering van het product, toon het op een licht stenen oppervlak onder zacht zijlicht en laat het bovenste derde deel vrij voor de aangeleverde kop.” Benoem voor een feitelijk diagram elke entiteit en verbinding en geef de goedgekeurde labels. Verfijn het resultaat in een gesprek door één wijziging en de te behouden kenmerken te benoemen en bewaar het geselecteerde beeld en de bijbehorende uitleg samen als ontwerpresultaat.
POST /v1/messagestextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3-pro-image | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten user, assistant | Standaard— |
Veldmessages[].content | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldmax_tokens | Typeinteger | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Tekst · UTF-8-tekst
messages[].content als tekenreeks
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, messages, max_tokens |
Parameteroptional_controls | Contractstream |
Parametermaterial_types | Contracttext |
Parametertext_file_material | ContractLees het werkelijke UTF-8-document en plaats de tekst ervan in de aangegeven invoer of in de inhoudstekenreeks van een bericht. |
Levenscyclus: synchronous_or_streamed
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Contexttokens, meer dan | Contexttokens, tot en met | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Contexttokens, meer dan— | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.004 / 1K tokens Uitvoer · Uitvoertokens $0.024 / 1K tokens Invoer · Cache lezen $0.0004 / 1K tokens Invoer · Cache schrijven $0.00075 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens Uitvoer · Tokens voor afbeeldingsuitvoer $0.24 / 1K afbeeldingstokens |
| ConfiguratieNiveau 1 voor aanvraaglengte | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.004 / 1K tokens Uitvoer · Uitvoertokens $0.024 / 1K tokens Invoer · Cache lezen $0.0004 / 1K tokens Invoer · Cache schrijven $0.00075 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
{\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 of SSE
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar alle inhoudsblokken, handtekeningen van redeneringen en werkelijke toolgebruik-ID’s. Voeg alle SSE-blokdelta’s samen; het eerste tekstblok is niet de volledige uitvoer.
Bewaar aanvraag-/antwoord-ID’s en headers. Er wordt geen algemene URL meegeleverd om teksttaken op te halen.
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldmodel | Typestring |
Veldcontent[] | Typetext|thinking|tool_use|other content block |
Veldstop_reason | Typestring|null |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
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
Technisch voorbeeld in het Engels
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.