Nano Banana 2 is Googles model Gemini 3.1 Flash Image voor beeldgeneratie en bewerking in gesprekken. Dit item behoudt de exacte Preview-identiteit. Een geschreven beschrijving kan een nieuw beeld definiëren, terwijl een invoerbeeld het te wijzigen onderwerp, uiterlijk of de compositie kan vastleggen. Het resultaat kan een beeld en bijbehorende tekst bevatten. Googles introductiemateriaal benadrukt wereldkennis, tekstweergave en onderwerpconsistentie, naast het verfijnen van een scène via samenhangende beurten.
Voor brongebaseerde visuele creatie kan het gedocumenteerde model informatie uit web- en beeldzoekopdrachten gebruiken om de generatie te sturen. Dat ondersteunt taken zoals een door een locatie geïnspireerde illustratie of een diagram op basis van aangeleverde informatie. Definieer de bronfeiten die moeten worden weergegeven en onderscheid die van artistieke keuzes. Zoekgestuurde generatie maakt niet elk detail in het eindbeeld een geverifieerde uitspraak. Geef als een product, herkenningspunt of diagram nauwkeurig moet zijn de gezaghebbende referentie en toets de uitvoer daaraan.
De introductie beschrijft verbeterde tekstweergave en lokalisatie in beelden. Geef voor een poster, infographic of marketingontwerp de exacte formulering, taal en rol van elk tekstelement. Leg eerst de tekst vast en vraag daarna om het beeld dat die bevat, zoals de beeldhandleiding aanbeveelt. Leg de leesvolgorde en onderlinge nadruk uit zodat een kop, bijschrift en diagramlabel niet worden verward. Controleer spelling, interpunctie en de koppeling tussen een label en het afgebeelde element voordat u het beeld publiceert.
Creatieve instellingen omvatten beeldverhouding en resolutie. De introductie voegt uitvoer van 512 pixels toe naast keuzes in 1K, 2K en 4K en voegt de beeldverhoudingen 4:1, 1:4, 8:1 en 1:8 toe. De ontwikkelaarshandleiding noemt minimal als standaarddenkniveau en high als optie voor complexere composities. Kies het beoogde gebruik vóór de compositie: een verticale story, brede banner en compact diagram vereisen verschillende ruimte voor het onderwerp en eventuele belettering. Die instellingen beschrijven de generatiestroom van de maker voor deze lijn, geen automatische schaalbewerking van een bestaand afgewerkt beeld.
Label voor onderwerpconsistentie de rol van elke referentie: productuiterlijk, personage-identiteit, achtergrond of visuele stijl. Benoem de te behouden details en daarna de elementen die moeten veranderen. Een oorspronkelijke taak kan een aangeleverde productfoto in een nieuwe scène plaatsen met behoud van vorm, materiaal en zichtbare merkuitingen. Behoud voor een geïllustreerde reeks dezelfde referenties en definieer welke scènedetails variëren. Meer referenties vervangen geen heldere instructie over wat elk beeld bijdraagt.
Bewerken in gesprekken is bruikbaar voor een specifieke revisie. Vraag één object, een achtergrond of de belichting aan te passen met behoud van de geaccepteerde compositie. De handleiding van de maker beschrijft semantische maskering, waarbij het bewerkte gebied in woorden wordt benoemd. Behoud bij werk over meerdere beurten het gesprek en de vereiste redeneercontextmetadata in de gekozen interface; de Gemini 3-handleiding legt uit dat gedachtehandtekeningen die context helpen overdragen. Een beschrijving van een ongewijzigd gebied is een instructie om aan het origineel te toetsen, geen garantie dat elke pixel identiek blijft.
De Gemini 3-ontwikkelaarstabel noemt expliciet gemini-3.1-flash-image-preview met 128K invoer- en 32K uitvoerruimte. Behoud de exacte Preview-modelnaam wanneer u generatie vastlegt. Bewaar de beschikbare referentie-, uitvoer- en resolutie-instellingen bij de bronbeelden en aanvraag zodat een revisie consistent kan worden gereproduceerd. Behoud bij een revisie dezelfde bronreferenties en specificeer de exacte visuele verandering met behoud van de geaccepteerde rol van elke invoer.
De beeldhandleiding waarschuwt dat het gevraagde aantal beelden niet altijd wordt gevolgd en noemt SynthID-markering voor gegenereerde beelden. Controleer alle teruggegeven beelden en eventuele bijbehorende tekst in plaats van aan te nemen dat het resultaat één vast beeld is. Inspecteer onderwerpidentiteit, objectaantal, tekst in beelden, compositie en referentiegetrouwheid op de beoogde weergavegrootte. Specificeer bij een complexe scène de componenten in een logische volgorde en beschrijf het gewenste uiterlijk positief. Het bruikbare resultaat is een beoordeeld beeldbestand met bronreferenties en exacte modelidentiteit voor de volgende bewerking.
", "aboutText": "Nano Banana 2 is Googles model Gemini 3.1 Flash Image voor beeldgeneratie en bewerking in gesprekken. Dit item behoudt de exacte Preview-identiteit. Een geschreven beschrijving kan een nieuw beeld definiëren, terwijl een invoerbeeld het te wijzigen onderwerp, uiterlijk of de compositie kan vastleggen. Het resultaat kan een beeld en bijbehorende tekst bevatten. Googles introductiemateriaal benadrukt wereldkennis, tekstweergave en onderwerpconsistentie, naast het verfijnen van een scène via samenhangende beurten.\n\nVoor brongebaseerde visuele creatie kan het gedocumenteerde model informatie uit web- en beeldzoekopdrachten gebruiken om de generatie te sturen. Dat ondersteunt taken zoals een door een locatie geïnspireerde illustratie of een diagram op basis van aangeleverde informatie. Definieer de bronfeiten die moeten worden weergegeven en onderscheid die van artistieke keuzes. Zoekgestuurde generatie maakt niet elk detail in het eindbeeld een geverifieerde uitspraak. Geef als een product, herkenningspunt of diagram nauwkeurig moet zijn de gezaghebbende referentie en toets de uitvoer daaraan.\n\nDe introductie beschrijft verbeterde tekstweergave en lokalisatie in beelden. Geef voor een poster, infographic of marketingontwerp de exacte formulering, taal en rol van elk tekstelement. Leg eerst de tekst vast en vraag daarna om het beeld dat die bevat, zoals de beeldhandleiding aanbeveelt. Leg de leesvolgorde en onderlinge nadruk uit zodat een kop, bijschrift en diagramlabel niet worden verward. Controleer spelling, interpunctie en de koppeling tussen een label en het afgebeelde element voordat u het beeld publiceert.\n\nCreatieve instellingen omvatten beeldverhouding en resolutie. De introductie voegt uitvoer van 512 pixels toe naast keuzes in 1K, 2K en 4K en voegt de beeldverhoudingen 4:1, 1:4, 8:1 en 1:8 toe. De ontwikkelaarshandleiding noemt minimal als standaarddenkniveau en high als optie voor complexere composities. Kies het beoogde gebruik vóór de compositie: een verticale story, brede banner en compact diagram vereisen verschillende ruimte voor het onderwerp en eventuele belettering. Die instellingen beschrijven de generatiestroom van de maker voor deze lijn, geen automatische schaalbewerking van een bestaand afgewerkt beeld.\n\nLabel voor onderwerpconsistentie de rol van elke referentie: productuiterlijk, personage-identiteit, achtergrond of visuele stijl. Benoem de te behouden details en daarna de elementen die moeten veranderen. Een oorspronkelijke taak kan een aangeleverde productfoto in een nieuwe scène plaatsen met behoud van vorm, materiaal en zichtbare merkuitingen. Behoud voor een geïllustreerde reeks dezelfde referenties en definieer welke scènedetails variëren. Meer referenties vervangen geen heldere instructie over wat elk beeld bijdraagt.\n\nBewerken in gesprekken is bruikbaar voor een specifieke revisie. Vraag één object, een achtergrond of de belichting aan te passen met behoud van de geaccepteerde compositie. De handleiding van de maker beschrijft semantische maskering, waarbij het bewerkte gebied in woorden wordt benoemd. Behoud bij werk over meerdere beurten het gesprek en de vereiste redeneercontextmetadata in de gekozen interface; de Gemini 3-handleiding legt uit dat gedachtehandtekeningen die context helpen overdragen. Een beschrijving van een ongewijzigd gebied is een instructie om aan het origineel te toetsen, geen garantie dat elke pixel identiek blijft.\n\nDe Gemini 3-ontwikkelaarstabel noemt expliciet gemini-3.1-flash-image-preview met 128K invoer- en 32K uitvoerruimte. Behoud de exacte Preview-modelnaam wanneer u generatie vastlegt. Bewaar de beschikbare referentie-, uitvoer- en resolutie-instellingen bij de bronbeelden en aanvraag zodat een revisie consistent kan worden gereproduceerd. Behoud bij een revisie dezelfde bronreferenties en specificeer de exacte visuele verandering met behoud van de geaccepteerde rol van elke invoer.\n\nDe beeldhandleiding waarschuwt dat het gevraagde aantal beelden niet altijd wordt gevolgd en noemt SynthID-markering voor gegenereerde beelden. Controleer alle teruggegeven beelden en eventuele bijbehorende tekst in plaats van aan te nemen dat het resultaat één vast beeld is. Inspecteer onderwerpidentiteit, objectaantal, tekst in beelden, compositie en referentiegetrouwheid op de beoogde weergavegrootte. Specificeer bij een complexe scène de componenten in een logische volgorde en beschrijf het gewenste uiterlijk positief. Het bruikbare resultaat is een beoordeeld beeldbestand met bronreferenties en exacte modelidentiteit voor de volgende bewerking.", "editorialOverlay": { "copy_fields": { "practical_html": "Technisch voorbeeld in het Engels
Create a four-stage growing guide\n\nCreate a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants.An image with four distinct growing stages in the specified order and a consistent illustration style.Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants.google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) maakt en bewerkt beelden uit tekst en visuele referenties. De gedocumenteerde sterke punten omvatten onderwerpconsistentie, tekst in beelden en lokalisatie, gespreksbewerkingen en creatieve controle over compositie, beeldverhouding en resolutie.
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 2 is Googles model Gemini 3.1 Flash Image voor beeldgeneratie en bewerking in gesprekken. Dit item behoudt de exacte Preview-identiteit. Een geschreven beschrijving kan een nieuw beeld definiëren, terwijl een invoerbeeld het te wijzigen onderwerp, uiterlijk of de compositie kan vastleggen. Het resultaat kan een beeld en bijbehorende tekst bevatten. Googles introductiemateriaal benadrukt wereldkennis, tekstweergave en onderwerpconsistentie, naast het verfijnen van een scène via samenhangende beurten.
Voor brongebaseerde visuele creatie kan het gedocumenteerde model informatie uit web- en beeldzoekopdrachten gebruiken om de generatie te sturen. Dat ondersteunt taken zoals een door een locatie geïnspireerde illustratie of een diagram op basis van aangeleverde informatie. Definieer de bronfeiten die moeten worden weergegeven en onderscheid die van artistieke keuzes. Zoekgestuurde generatie maakt niet elk detail in het eindbeeld een geverifieerde uitspraak. Geef als een product, herkenningspunt of diagram nauwkeurig moet zijn de gezaghebbende referentie en toets de uitvoer daaraan.
De introductie beschrijft verbeterde tekstweergave en lokalisatie in beelden. Geef voor een poster, infographic of marketingontwerp de exacte formulering, taal en rol van elk tekstelement. Leg eerst de tekst vast en vraag daarna om het beeld dat die bevat, zoals de beeldhandleiding aanbeveelt. Leg de leesvolgorde en onderlinge nadruk uit zodat een kop, bijschrift en diagramlabel niet worden verward. Controleer spelling, interpunctie en de koppeling tussen een label en het afgebeelde element voordat u het beeld publiceert.
Creatieve instellingen omvatten beeldverhouding en resolutie. De introductie voegt uitvoer van 512 pixels toe naast keuzes in 1K, 2K en 4K en voegt de beeldverhoudingen 4:1, 1:4, 8:1 en 1:8 toe. De ontwikkelaarshandleiding noemt minimal als standaarddenkniveau en high als optie voor complexere composities. Kies het beoogde gebruik vóór de compositie: een verticale story, brede banner en compact diagram vereisen verschillende ruimte voor het onderwerp en eventuele belettering. Die instellingen beschrijven de generatiestroom van de maker voor deze lijn, geen automatische schaalbewerking van een bestaand afgewerkt beeld.
Label voor onderwerpconsistentie de rol van elke referentie: productuiterlijk, personage-identiteit, achtergrond of visuele stijl. Benoem de te behouden details en daarna de elementen die moeten veranderen. Een oorspronkelijke taak kan een aangeleverde productfoto in een nieuwe scène plaatsen met behoud van vorm, materiaal en zichtbare merkuitingen. Behoud voor een geïllustreerde reeks dezelfde referenties en definieer welke scènedetails variëren. Meer referenties vervangen geen heldere instructie over wat elk beeld bijdraagt.
Bewerken in gesprekken is bruikbaar voor een specifieke revisie. Vraag één object, een achtergrond of de belichting aan te passen met behoud van de geaccepteerde compositie. De handleiding van de maker beschrijft semantische maskering, waarbij het bewerkte gebied in woorden wordt benoemd. Behoud bij werk over meerdere beurten het gesprek en de vereiste redeneercontextmetadata in de gekozen interface; de Gemini 3-handleiding legt uit dat gedachtehandtekeningen die context helpen overdragen. Een beschrijving van een ongewijzigd gebied is een instructie om aan het origineel te toetsen, geen garantie dat elke pixel identiek blijft.
De Gemini 3-ontwikkelaarstabel noemt expliciet gemini-3.1-flash-image-preview met 128K invoer- en 32K uitvoerruimte. Behoud de exacte Preview-modelnaam wanneer u generatie vastlegt. Bewaar de beschikbare referentie-, uitvoer- en resolutie-instellingen bij de bronbeelden en aanvraag zodat een revisie consistent kan worden gereproduceerd. Behoud bij een revisie dezelfde bronreferenties en specificeer de exacte visuele verandering met behoud van de geaccepteerde rol van elke invoer.
De beeldhandleiding waarschuwt dat het gevraagde aantal beelden niet altijd wordt gevolgd en noemt SynthID-markering voor gegenereerde beelden. Controleer alle teruggegeven beelden en eventuele bijbehorende tekst in plaats van aan te nemen dat het resultaat één vast beeld is. Inspecteer onderwerpidentiteit, objectaantal, tekst in beelden, compositie en referentiegetrouwheid op de beoogde weergavegrootte. Specificeer bij een complexe scène de componenten in een logische volgorde en beschrijf het gewenste uiterlijk positief. Het bruikbare resultaat is een beoordeeld beeldbestand met bronreferenties en exacte modelidentiteit voor de volgende bewerking.
POST /v1/chat/completionstexttext| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3.1-flash-image-preview | 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.001 / 1K tokens Uitvoer · Uitvoertokens $0.006 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens Uitvoer · Tokens voor afbeeldingsuitvoer $0.12 / 1K afbeeldingstokens |
| ConfiguratieNiveau 1 voor aanvraaglengte | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.001 / 1K tokens Uitvoer · Uitvoertokens $0.006 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 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/gemini-3.1-flash-image-preview · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,001 / 1K tokens Uitvoer · Uitvoer US$ 0,12 / 1K tokens |
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| Configuratiegoogle/gemini-3.1-flash-image-preview · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,001 / 1K tokens Uitvoer · Uitvoer US$ 0,12 / 1K tokens |
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| Configuratiegoogle/gemini-3.1-flash-image-preview · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,16 per aanroep |
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| Configuratiegoogle/gemini-3.1-flash-image-preview · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,32 per aanroep |
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| Configuratiegoogle/gemini-3.1-flash-image-preview · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,00 per aanroep |
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoertokens US$ 0,001 / 1K tokens Uitvoer · Uitvoertokens US$ 0,006 / 1K tokens Uitvoer · Uitvoerafbeelding US$ 0,12 / 1K tokens Uitvoer · Zoeken op het web US$ 0,028 per zoekopdracht |
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.1-flash-image-preview", "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.1-flash-image-preview',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.1-flash-image-preview',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 Ultra google/gemini-3.1-flash-image-preview
/v1/images
google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) maakt en bewerkt beelden uit tekst en visuele referenties. De gedocumenteerde sterke punten omvatten onderwerpconsistentie, tekst in beelden en lokalisatie, gespreksbewerkingen en creatieve controle over compositie, beeldverhouding en resolutie.
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 2 is Googles model Gemini 3.1 Flash Image voor beeldgeneratie en bewerking in gesprekken. Dit item behoudt de exacte Preview-identiteit. Een geschreven beschrijving kan een nieuw beeld definiëren, terwijl een invoerbeeld het te wijzigen onderwerp, uiterlijk of de compositie kan vastleggen. Het resultaat kan een beeld en bijbehorende tekst bevatten. Googles introductiemateriaal benadrukt wereldkennis, tekstweergave en onderwerpconsistentie, naast het verfijnen van een scène via samenhangende beurten.
Voor brongebaseerde visuele creatie kan het gedocumenteerde model informatie uit web- en beeldzoekopdrachten gebruiken om de generatie te sturen. Dat ondersteunt taken zoals een door een locatie geïnspireerde illustratie of een diagram op basis van aangeleverde informatie. Definieer de bronfeiten die moeten worden weergegeven en onderscheid die van artistieke keuzes. Zoekgestuurde generatie maakt niet elk detail in het eindbeeld een geverifieerde uitspraak. Geef als een product, herkenningspunt of diagram nauwkeurig moet zijn de gezaghebbende referentie en toets de uitvoer daaraan.
De introductie beschrijft verbeterde tekstweergave en lokalisatie in beelden. Geef voor een poster, infographic of marketingontwerp de exacte formulering, taal en rol van elk tekstelement. Leg eerst de tekst vast en vraag daarna om het beeld dat die bevat, zoals de beeldhandleiding aanbeveelt. Leg de leesvolgorde en onderlinge nadruk uit zodat een kop, bijschrift en diagramlabel niet worden verward. Controleer spelling, interpunctie en de koppeling tussen een label en het afgebeelde element voordat u het beeld publiceert.
Creatieve instellingen omvatten beeldverhouding en resolutie. De introductie voegt uitvoer van 512 pixels toe naast keuzes in 1K, 2K en 4K en voegt de beeldverhoudingen 4:1, 1:4, 8:1 en 1:8 toe. De ontwikkelaarshandleiding noemt minimal als standaarddenkniveau en high als optie voor complexere composities. Kies het beoogde gebruik vóór de compositie: een verticale story, brede banner en compact diagram vereisen verschillende ruimte voor het onderwerp en eventuele belettering. Die instellingen beschrijven de generatiestroom van de maker voor deze lijn, geen automatische schaalbewerking van een bestaand afgewerkt beeld.
Label voor onderwerpconsistentie de rol van elke referentie: productuiterlijk, personage-identiteit, achtergrond of visuele stijl. Benoem de te behouden details en daarna de elementen die moeten veranderen. Een oorspronkelijke taak kan een aangeleverde productfoto in een nieuwe scène plaatsen met behoud van vorm, materiaal en zichtbare merkuitingen. Behoud voor een geïllustreerde reeks dezelfde referenties en definieer welke scènedetails variëren. Meer referenties vervangen geen heldere instructie over wat elk beeld bijdraagt.
Bewerken in gesprekken is bruikbaar voor een specifieke revisie. Vraag één object, een achtergrond of de belichting aan te passen met behoud van de geaccepteerde compositie. De handleiding van de maker beschrijft semantische maskering, waarbij het bewerkte gebied in woorden wordt benoemd. Behoud bij werk over meerdere beurten het gesprek en de vereiste redeneercontextmetadata in de gekozen interface; de Gemini 3-handleiding legt uit dat gedachtehandtekeningen die context helpen overdragen. Een beschrijving van een ongewijzigd gebied is een instructie om aan het origineel te toetsen, geen garantie dat elke pixel identiek blijft.
De Gemini 3-ontwikkelaarstabel noemt expliciet gemini-3.1-flash-image-preview met 128K invoer- en 32K uitvoerruimte. Behoud de exacte Preview-modelnaam wanneer u generatie vastlegt. Bewaar de beschikbare referentie-, uitvoer- en resolutie-instellingen bij de bronbeelden en aanvraag zodat een revisie consistent kan worden gereproduceerd. Behoud bij een revisie dezelfde bronreferenties en specificeer de exacte visuele verandering met behoud van de geaccepteerde rol van elke invoer.
De beeldhandleiding waarschuwt dat het gevraagde aantal beelden niet altijd wordt gevolgd en noemt SynthID-markering voor gegenereerde beelden. Controleer alle teruggegeven beelden en eventuele bijbehorende tekst in plaats van aan te nemen dat het resultaat één vast beeld is. Inspecteer onderwerpidentiteit, objectaantal, tekst in beelden, compositie en referentiegetrouwheid op de beoogde weergavegrootte. Specificeer bij een complexe scène de componenten in een logische volgorde en beschrijf het gewenste uiterlijk positief. Het bruikbare resultaat is een beoordeeld beeldbestand met bronreferenties en exacte modelidentiteit voor de volgende bewerking.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3.1-flash-image-preview | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 512, 1K, 2K, 4K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | 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.49152 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.1-flash-image-preview', '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 Ultra google/gemini-3.1-flash-image-preview
/v1/images
google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) maakt en bewerkt beelden uit tekst en visuele referenties. De gedocumenteerde sterke punten omvatten onderwerpconsistentie, tekst in beelden en lokalisatie, gespreksbewerkingen en creatieve controle over compositie, beeldverhouding en resolutie.
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 2 is Googles model Gemini 3.1 Flash Image voor beeldgeneratie en bewerking in gesprekken. Dit item behoudt de exacte Preview-identiteit. Een geschreven beschrijving kan een nieuw beeld definiëren, terwijl een invoerbeeld het te wijzigen onderwerp, uiterlijk of de compositie kan vastleggen. Het resultaat kan een beeld en bijbehorende tekst bevatten. Googles introductiemateriaal benadrukt wereldkennis, tekstweergave en onderwerpconsistentie, naast het verfijnen van een scène via samenhangende beurten.
Voor brongebaseerde visuele creatie kan het gedocumenteerde model informatie uit web- en beeldzoekopdrachten gebruiken om de generatie te sturen. Dat ondersteunt taken zoals een door een locatie geïnspireerde illustratie of een diagram op basis van aangeleverde informatie. Definieer de bronfeiten die moeten worden weergegeven en onderscheid die van artistieke keuzes. Zoekgestuurde generatie maakt niet elk detail in het eindbeeld een geverifieerde uitspraak. Geef als een product, herkenningspunt of diagram nauwkeurig moet zijn de gezaghebbende referentie en toets de uitvoer daaraan.
De introductie beschrijft verbeterde tekstweergave en lokalisatie in beelden. Geef voor een poster, infographic of marketingontwerp de exacte formulering, taal en rol van elk tekstelement. Leg eerst de tekst vast en vraag daarna om het beeld dat die bevat, zoals de beeldhandleiding aanbeveelt. Leg de leesvolgorde en onderlinge nadruk uit zodat een kop, bijschrift en diagramlabel niet worden verward. Controleer spelling, interpunctie en de koppeling tussen een label en het afgebeelde element voordat u het beeld publiceert.
Creatieve instellingen omvatten beeldverhouding en resolutie. De introductie voegt uitvoer van 512 pixels toe naast keuzes in 1K, 2K en 4K en voegt de beeldverhoudingen 4:1, 1:4, 8:1 en 1:8 toe. De ontwikkelaarshandleiding noemt minimal als standaarddenkniveau en high als optie voor complexere composities. Kies het beoogde gebruik vóór de compositie: een verticale story, brede banner en compact diagram vereisen verschillende ruimte voor het onderwerp en eventuele belettering. Die instellingen beschrijven de generatiestroom van de maker voor deze lijn, geen automatische schaalbewerking van een bestaand afgewerkt beeld.
Label voor onderwerpconsistentie de rol van elke referentie: productuiterlijk, personage-identiteit, achtergrond of visuele stijl. Benoem de te behouden details en daarna de elementen die moeten veranderen. Een oorspronkelijke taak kan een aangeleverde productfoto in een nieuwe scène plaatsen met behoud van vorm, materiaal en zichtbare merkuitingen. Behoud voor een geïllustreerde reeks dezelfde referenties en definieer welke scènedetails variëren. Meer referenties vervangen geen heldere instructie over wat elk beeld bijdraagt.
Bewerken in gesprekken is bruikbaar voor een specifieke revisie. Vraag één object, een achtergrond of de belichting aan te passen met behoud van de geaccepteerde compositie. De handleiding van de maker beschrijft semantische maskering, waarbij het bewerkte gebied in woorden wordt benoemd. Behoud bij werk over meerdere beurten het gesprek en de vereiste redeneercontextmetadata in de gekozen interface; de Gemini 3-handleiding legt uit dat gedachtehandtekeningen die context helpen overdragen. Een beschrijving van een ongewijzigd gebied is een instructie om aan het origineel te toetsen, geen garantie dat elke pixel identiek blijft.
De Gemini 3-ontwikkelaarstabel noemt expliciet gemini-3.1-flash-image-preview met 128K invoer- en 32K uitvoerruimte. Behoud de exacte Preview-modelnaam wanneer u generatie vastlegt. Bewaar de beschikbare referentie-, uitvoer- en resolutie-instellingen bij de bronbeelden en aanvraag zodat een revisie consistent kan worden gereproduceerd. Behoud bij een revisie dezelfde bronreferenties en specificeer de exacte visuele verandering met behoud van de geaccepteerde rol van elke invoer.
De beeldhandleiding waarschuwt dat het gevraagde aantal beelden niet altijd wordt gevolgd en noemt SynthID-markering voor gegenereerde beelden. Controleer alle teruggegeven beelden en eventuele bijbehorende tekst in plaats van aan te nemen dat het resultaat één vast beeld is. Inspecteer onderwerpidentiteit, objectaantal, tekst in beelden, compositie en referentiegetrouwheid op de beoogde weergavegrootte. Specificeer bij een complexe scène de componenten in een logische volgorde en beschrijf het gewenste uiterlijk positief. Het bruikbare resultaat is een beoordeeld beeldbestand met bronreferenties en exacte modelidentiteit voor de volgende bewerking.
POST /v1/messagestextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3.1-flash-image-preview | 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.001 / 1K tokens Uitvoer · Uitvoertokens $0.006 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens Uitvoer · Tokens voor afbeeldingsuitvoer $0.12 / 1K afbeeldingstokens |
| ConfiguratieNiveau 1 voor aanvraaglengte | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.001 / 1K tokens Uitvoer · Uitvoertokens $0.006 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 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.1-flash-image-preview",\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.1-flash-image-preview', '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.1-flash-image-preview', '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 Ultra google/gemini-3.1-flash-image-preview
/v1/images
Technisch voorbeeld in het Engels
Create a four-stage growing guide\n\nCreate a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants.An image with four distinct growing stages in the specified order and a consistent illustration style.Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants.