Gemini 3 Flash Preview is een redeneermodel van Google voor multimodaal begrip, programmeren en agenttaken. Het accepteert tekst, afbeeldingen, video, audio en PDF en geeft tekst terug. Een verzoek kan zo geschreven instructies, bronbestanden, visuele waarnemingen en gespreksgeschiedenis rond één probleem samenbrengen. Het resultaat kan een uitleg, codevoorstel, geëxtraheerde gegevens of een op dat materiaal gebaseerd plan zijn, in plaats van een gegenereerde afbeelding of gesproken antwoord.
De modelspecifieke kaart vermeldt een invoerlimiet van 1.048.576 tokens en een uitvoerlimiet van 65.536 tokens. Plan bronmateriaal en resultaat afzonderlijk: een lang fragment uit een repository, een verzameling documenten of een opname past alleen als de verwerkte weergave en de instructies binnen het invoerbudget blijven, terwijl het antwoord nog een eigen lengtebudget nodig heeft. Geef samenhangende bronnen labels en benoem welk materiaal leidend is. Voor een lange prompt raadt de ontwikkelaarsgids aan om de concrete vraag na de gegevens te plaatsen en expliciet aan de voorafgaande informatie te koppelen.
Het denken is dynamisch; high is de gedocumenteerde standaard voor dit model. De ondersteunde niveaus zijn minimal, low, medium en high. Het zijn relatieve budgetten voor redeneren, geen gegarandeerde aantallen tokens. Minimal kan bij een lastig programmeerprobleem nog steeds enig redeneren omvatten. Kies een niveau passend bij de taak: een korte omzetting en een foutonderzoek met meerdere voorwaarden vragen om een andere aanpak. Gebruik directe, duidelijke instructies in plaats van uitgebreide redeneerrituelen af te dwingen; vraag om het uiteindelijke resultaat en de controles die het bruikbaar maken.
De kaart van de maker vermeldt gestructureerde uitvoer, function calling, code-uitvoering, computergebruik, bestandszoekfuncties, search grounding, Google Maps grounding, URL-context en caching. In de gedocumenteerde Gemini 3-werkwijze kunnen ingebouwde tools worden gecombineerd met eigen function calling. Een toepassing definieert de functies, controleert hun argumenten, voert toegestane acties uit en stuurt de resultaten terug. Voor een programmeerassistent kan een tool voor het lezen van bestanden of een gecontroleerde testrunner concreet bewijs leveren voor de volgende stap. Houd een voorgestelde actie en een waargenomen toolresultaat in het eindverslag duidelijk uit elkaar.
Geef bij programmeerwerk de relevante bestanden, taal, het verwachte gedrag en een invoer die het probleem laat zien. Baken de wijziging af en benoem welke interface of welk gedrag behouden moet blijven. Vraag om een aangepaste implementatie en de gevallen die moeten worden gecontroleerd. Definieer bij een analytische documenttaak de vraag, vereiste velden en bronverwijzingen. Lever bij gestructureerde uitvoer een schema met duidelijke veldbetekenissen en regels voor ontbrekende waarden. Valideer zowel de syntaxis als de vraag of elke waarde uit het oorspronkelijke materiaal volgt.
Benoem bij multimodale analyse wat in elke bron van belang is. Een schermafbeelding kan een interface-uitleg ondersteunen, een PDF kan een tabel of grafiek aanleveren en een opname kan gesproken of zichtbare gebeurtenissen bevatten. De ontwikkelaarsgids bespreekt instellingen voor mediaresolutie omdat het detailniveau de verwerkte weergave en het tokengebruik beïnvloedt. De code-uitvoeringsworkflow van de maker kan aangeleverde afbeeldingen bijsnijden of uitvergroten, berekeningen uitvoeren met visuele gegevens en annotaties toevoegen voordat het model antwoordt. Leesbare kleine tekst kan een andere instelling vereisen dan een globale scènebeschrijving. Houd de relevante pagina, afbeelding of clip beschikbaar om waarnemingen te controleren; een vloeiende samenvatting bewijst niet dat elk detail correct is gelezen.
Gespreks- en toolstatus moeten in de gekozen interface behouden blijven. Gemini 3 gebruikt thought signatures om redeneercontext tussen aanroepen mee te nemen; de ontwikkelaarsgids onderscheidt beheerde gespreksgeschiedenis met status van handmatig beheerde geschiedenis zonder status. Bewaar de vereiste context wanneer je een tooltaak voortzet of een resultaat herziet. Google raadt ook aan om de standaardtemperatuur van 1.0 te behouden, in plaats van een aanpak met lage temperatuur over te nemen die bij complexe taken lussen of slechter gedrag kan veroorzaken. Dit zijn integratiepraktijken van de maker, geen nieuwe claims over het transport van een specifieke toepassing.
Het tekstmodel vermeldt geen beeld- of audiogeneratie of de Live API. De gids onderscheidt visueel begrip ook van beeldsegmentatie op pixelniveau, een mogelijkheid die Gemini 3 Flash niet ondersteunt. Kies een eindresultaat dat bij de werkelijke taak past: waarnemingen met bronverwijzingen, een gestructureerd record, een codewijziging of een beslissing met expliciete aannames. Controleer berekeningen, verifieer code in de beoogde omgeving en beoordeel teruggegeven toolinformatie. Gebruik bij recente feiten de ingestelde grounding-bronnen of actuele aangeleverde gegevens, in plaats van modelkennis als een live database te behandelen.
", "aboutText": "Gemini 3 Flash Preview is een redeneermodel van Google voor multimodaal begrip, programmeren en agenttaken. Het accepteert tekst, afbeeldingen, video, audio en PDF en geeft tekst terug. Een verzoek kan zo geschreven instructies, bronbestanden, visuele waarnemingen en gespreksgeschiedenis rond één probleem samenbrengen. Het resultaat kan een uitleg, codevoorstel, geëxtraheerde gegevens of een op dat materiaal gebaseerd plan zijn, in plaats van een gegenereerde afbeelding of gesproken antwoord.\n\nDe modelspecifieke kaart vermeldt een invoerlimiet van 1.048.576 tokens en een uitvoerlimiet van 65.536 tokens. Plan bronmateriaal en resultaat afzonderlijk: een lang fragment uit een repository, een verzameling documenten of een opname past alleen als de verwerkte weergave en de instructies binnen het invoerbudget blijven, terwijl het antwoord nog een eigen lengtebudget nodig heeft. Geef samenhangende bronnen labels en benoem welk materiaal leidend is. Voor een lange prompt raadt de ontwikkelaarsgids aan om de concrete vraag na de gegevens te plaatsen en expliciet aan de voorafgaande informatie te koppelen.\n\nHet denken is dynamisch; high is de gedocumenteerde standaard voor dit model. De ondersteunde niveaus zijn minimal, low, medium en high. Het zijn relatieve budgetten voor redeneren, geen gegarandeerde aantallen tokens. Minimal kan bij een lastig programmeerprobleem nog steeds enig redeneren omvatten. Kies een niveau passend bij de taak: een korte omzetting en een foutonderzoek met meerdere voorwaarden vragen om een andere aanpak. Gebruik directe, duidelijke instructies in plaats van uitgebreide redeneerrituelen af te dwingen; vraag om het uiteindelijke resultaat en de controles die het bruikbaar maken.\n\nDe kaart van de maker vermeldt gestructureerde uitvoer, function calling, code-uitvoering, computergebruik, bestandszoekfuncties, search grounding, Google Maps grounding, URL-context en caching. In de gedocumenteerde Gemini 3-werkwijze kunnen ingebouwde tools worden gecombineerd met eigen function calling. Een toepassing definieert de functies, controleert hun argumenten, voert toegestane acties uit en stuurt de resultaten terug. Voor een programmeerassistent kan een tool voor het lezen van bestanden of een gecontroleerde testrunner concreet bewijs leveren voor de volgende stap. Houd een voorgestelde actie en een waargenomen toolresultaat in het eindverslag duidelijk uit elkaar.\n\nGeef bij programmeerwerk de relevante bestanden, taal, het verwachte gedrag en een invoer die het probleem laat zien. Baken de wijziging af en benoem welke interface of welk gedrag behouden moet blijven. Vraag om een aangepaste implementatie en de gevallen die moeten worden gecontroleerd. Definieer bij een analytische documenttaak de vraag, vereiste velden en bronverwijzingen. Lever bij gestructureerde uitvoer een schema met duidelijke veldbetekenissen en regels voor ontbrekende waarden. Valideer zowel de syntaxis als de vraag of elke waarde uit het oorspronkelijke materiaal volgt.\n\nBenoem bij multimodale analyse wat in elke bron van belang is. Een schermafbeelding kan een interface-uitleg ondersteunen, een PDF kan een tabel of grafiek aanleveren en een opname kan gesproken of zichtbare gebeurtenissen bevatten. De ontwikkelaarsgids bespreekt instellingen voor mediaresolutie omdat het detailniveau de verwerkte weergave en het tokengebruik beïnvloedt. De code-uitvoeringsworkflow van de maker kan aangeleverde afbeeldingen bijsnijden of uitvergroten, berekeningen uitvoeren met visuele gegevens en annotaties toevoegen voordat het model antwoordt. Leesbare kleine tekst kan een andere instelling vereisen dan een globale scènebeschrijving. Houd de relevante pagina, afbeelding of clip beschikbaar om waarnemingen te controleren; een vloeiende samenvatting bewijst niet dat elk detail correct is gelezen.\n\nGespreks- en toolstatus moeten in de gekozen interface behouden blijven. Gemini 3 gebruikt thought signatures om redeneercontext tussen aanroepen mee te nemen; de ontwikkelaarsgids onderscheidt beheerde gespreksgeschiedenis met status van handmatig beheerde geschiedenis zonder status. Bewaar de vereiste context wanneer je een tooltaak voortzet of een resultaat herziet. Google raadt ook aan om de standaardtemperatuur van 1.0 te behouden, in plaats van een aanpak met lage temperatuur over te nemen die bij complexe taken lussen of slechter gedrag kan veroorzaken. Dit zijn integratiepraktijken van de maker, geen nieuwe claims over het transport van een specifieke toepassing.\n\nHet tekstmodel vermeldt geen beeld- of audiogeneratie of de Live API. De gids onderscheidt visueel begrip ook van beeldsegmentatie op pixelniveau, een mogelijkheid die Gemini 3 Flash niet ondersteunt. Kies een eindresultaat dat bij de werkelijke taak past: waarnemingen met bronverwijzingen, een gestructureerd record, een codewijziging of een beslissing met expliciete aannames. Controleer berekeningen, verifieer code in de beoogde omgeving en beoordeel teruggegeven toolinformatie. Gebruik bij recente feiten de ingestelde grounding-bronnen of actuele aangeleverde gegevens, in plaats van modelkennis als een live database te behandelen.", "editorialOverlay": { "copy_fields": { "practical_html": "Technisch voorbeeld in het Engels
Keep a sorting helper immutable\n\nFix this JavaScript helper so it returns users sorted by name without changing the input array: function sortedUsers(users) { return users.sort((a,b) => a.name.localeCompare(b.name)); }. Preserve each user object. Return the revised function and tests for alphabetical order, an empty array and the unchanged original array.A revised function and three small test examples covering sorting and non-mutation.Check that the returned array is a different array and the original sequence is unchanged after the call.gemini-3-flash-previewGemini 3 Flash Preview combineert multimodaal begrip en redeneren met tekstuitvoer. Het ondersteunt code-, document- en beeldanalyse, gestructureerde resultaten en workflows met tools, met vier gedocumenteerde denkniveaus om de diepgang van de analyse te kiezen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Gemini 3 Flash Preview is een redeneermodel van Google voor multimodaal begrip, programmeren en agenttaken. Het accepteert tekst, afbeeldingen, video, audio en PDF en geeft tekst terug. Een verzoek kan zo geschreven instructies, bronbestanden, visuele waarnemingen en gespreksgeschiedenis rond één probleem samenbrengen. Het resultaat kan een uitleg, codevoorstel, geëxtraheerde gegevens of een op dat materiaal gebaseerd plan zijn, in plaats van een gegenereerde afbeelding of gesproken antwoord.
De modelspecifieke kaart vermeldt een invoerlimiet van 1.048.576 tokens en een uitvoerlimiet van 65.536 tokens. Plan bronmateriaal en resultaat afzonderlijk: een lang fragment uit een repository, een verzameling documenten of een opname past alleen als de verwerkte weergave en de instructies binnen het invoerbudget blijven, terwijl het antwoord nog een eigen lengtebudget nodig heeft. Geef samenhangende bronnen labels en benoem welk materiaal leidend is. Voor een lange prompt raadt de ontwikkelaarsgids aan om de concrete vraag na de gegevens te plaatsen en expliciet aan de voorafgaande informatie te koppelen.
Het denken is dynamisch; high is de gedocumenteerde standaard voor dit model. De ondersteunde niveaus zijn minimal, low, medium en high. Het zijn relatieve budgetten voor redeneren, geen gegarandeerde aantallen tokens. Minimal kan bij een lastig programmeerprobleem nog steeds enig redeneren omvatten. Kies een niveau passend bij de taak: een korte omzetting en een foutonderzoek met meerdere voorwaarden vragen om een andere aanpak. Gebruik directe, duidelijke instructies in plaats van uitgebreide redeneerrituelen af te dwingen; vraag om het uiteindelijke resultaat en de controles die het bruikbaar maken.
De kaart van de maker vermeldt gestructureerde uitvoer, function calling, code-uitvoering, computergebruik, bestandszoekfuncties, search grounding, Google Maps grounding, URL-context en caching. In de gedocumenteerde Gemini 3-werkwijze kunnen ingebouwde tools worden gecombineerd met eigen function calling. Een toepassing definieert de functies, controleert hun argumenten, voert toegestane acties uit en stuurt de resultaten terug. Voor een programmeerassistent kan een tool voor het lezen van bestanden of een gecontroleerde testrunner concreet bewijs leveren voor de volgende stap. Houd een voorgestelde actie en een waargenomen toolresultaat in het eindverslag duidelijk uit elkaar.
Geef bij programmeerwerk de relevante bestanden, taal, het verwachte gedrag en een invoer die het probleem laat zien. Baken de wijziging af en benoem welke interface of welk gedrag behouden moet blijven. Vraag om een aangepaste implementatie en de gevallen die moeten worden gecontroleerd. Definieer bij een analytische documenttaak de vraag, vereiste velden en bronverwijzingen. Lever bij gestructureerde uitvoer een schema met duidelijke veldbetekenissen en regels voor ontbrekende waarden. Valideer zowel de syntaxis als de vraag of elke waarde uit het oorspronkelijke materiaal volgt.
Benoem bij multimodale analyse wat in elke bron van belang is. Een schermafbeelding kan een interface-uitleg ondersteunen, een PDF kan een tabel of grafiek aanleveren en een opname kan gesproken of zichtbare gebeurtenissen bevatten. De ontwikkelaarsgids bespreekt instellingen voor mediaresolutie omdat het detailniveau de verwerkte weergave en het tokengebruik beïnvloedt. De code-uitvoeringsworkflow van de maker kan aangeleverde afbeeldingen bijsnijden of uitvergroten, berekeningen uitvoeren met visuele gegevens en annotaties toevoegen voordat het model antwoordt. Leesbare kleine tekst kan een andere instelling vereisen dan een globale scènebeschrijving. Houd de relevante pagina, afbeelding of clip beschikbaar om waarnemingen te controleren; een vloeiende samenvatting bewijst niet dat elk detail correct is gelezen.
Gespreks- en toolstatus moeten in de gekozen interface behouden blijven. Gemini 3 gebruikt thought signatures om redeneercontext tussen aanroepen mee te nemen; de ontwikkelaarsgids onderscheidt beheerde gespreksgeschiedenis met status van handmatig beheerde geschiedenis zonder status. Bewaar de vereiste context wanneer je een tooltaak voortzet of een resultaat herziet. Google raadt ook aan om de standaardtemperatuur van 1.0 te behouden, in plaats van een aanpak met lage temperatuur over te nemen die bij complexe taken lussen of slechter gedrag kan veroorzaken. Dit zijn integratiepraktijken van de maker, geen nieuwe claims over het transport van een specifieke toepassing.
Het tekstmodel vermeldt geen beeld- of audiogeneratie of de Live API. De gids onderscheidt visueel begrip ook van beeldsegmentatie op pixelniveau, een mogelijkheid die Gemini 3 Flash niet ondersteunt. Kies een eindresultaat dat bij de werkelijke taak past: waarnemingen met bronverwijzingen, een gestructureerd record, een codewijziging of een beslissing met expliciete aannames. Controleer berekeningen, verifieer code in de beoogde omgeving en beoordeel teruggegeven toolinformatie. Gebruik bij recente feiten de ingestelde grounding-bronnen of actuele aangeleverde gegevens, in plaats van modelkennis als een live database te behandelen.
POST /v1/chat/completionstexttext| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gemini-3-flash-preview | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmessages[].content | Typestring | VereisteOptioneel | Waarden en limieten Geldt wanneer: Tekstgesprek | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
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 |
Parametercontrol_scope | ContractTekstgesprek; stream is een booleaanse waarde en is standaard false. |
Parameteroutput_modalities | Contracttext |
Parameterhosted_operations | Contractfalse |
Parametermultimodal_input_binding | Contractnull |
Methodealiasnamen: /chat/completions
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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| 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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 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 →
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":"gemini-3-flash-preview","messages":[{"role":"user","content":"hello"}],"stream":false}')\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="gemini-3-flash-preview", messages=[{"role":"user","content":"hello"}], stream=False)\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"))\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 gemini-3-flash-preview, google/gemini-3-flash-preview
/chat/completions
gemini-3-flash-previewGemini 3 Flash Preview combineert multimodaal begrip en redeneren met tekstuitvoer. Het ondersteunt code-, document- en beeldanalyse, gestructureerde resultaten en workflows met tools, met vier gedocumenteerde denkniveaus om de diepgang van de analyse te kiezen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Gemini 3 Flash Preview is een redeneermodel van Google voor multimodaal begrip, programmeren en agenttaken. Het accepteert tekst, afbeeldingen, video, audio en PDF en geeft tekst terug. Een verzoek kan zo geschreven instructies, bronbestanden, visuele waarnemingen en gespreksgeschiedenis rond één probleem samenbrengen. Het resultaat kan een uitleg, codevoorstel, geëxtraheerde gegevens of een op dat materiaal gebaseerd plan zijn, in plaats van een gegenereerde afbeelding of gesproken antwoord.
De modelspecifieke kaart vermeldt een invoerlimiet van 1.048.576 tokens en een uitvoerlimiet van 65.536 tokens. Plan bronmateriaal en resultaat afzonderlijk: een lang fragment uit een repository, een verzameling documenten of een opname past alleen als de verwerkte weergave en de instructies binnen het invoerbudget blijven, terwijl het antwoord nog een eigen lengtebudget nodig heeft. Geef samenhangende bronnen labels en benoem welk materiaal leidend is. Voor een lange prompt raadt de ontwikkelaarsgids aan om de concrete vraag na de gegevens te plaatsen en expliciet aan de voorafgaande informatie te koppelen.
Het denken is dynamisch; high is de gedocumenteerde standaard voor dit model. De ondersteunde niveaus zijn minimal, low, medium en high. Het zijn relatieve budgetten voor redeneren, geen gegarandeerde aantallen tokens. Minimal kan bij een lastig programmeerprobleem nog steeds enig redeneren omvatten. Kies een niveau passend bij de taak: een korte omzetting en een foutonderzoek met meerdere voorwaarden vragen om een andere aanpak. Gebruik directe, duidelijke instructies in plaats van uitgebreide redeneerrituelen af te dwingen; vraag om het uiteindelijke resultaat en de controles die het bruikbaar maken.
De kaart van de maker vermeldt gestructureerde uitvoer, function calling, code-uitvoering, computergebruik, bestandszoekfuncties, search grounding, Google Maps grounding, URL-context en caching. In de gedocumenteerde Gemini 3-werkwijze kunnen ingebouwde tools worden gecombineerd met eigen function calling. Een toepassing definieert de functies, controleert hun argumenten, voert toegestane acties uit en stuurt de resultaten terug. Voor een programmeerassistent kan een tool voor het lezen van bestanden of een gecontroleerde testrunner concreet bewijs leveren voor de volgende stap. Houd een voorgestelde actie en een waargenomen toolresultaat in het eindverslag duidelijk uit elkaar.
Geef bij programmeerwerk de relevante bestanden, taal, het verwachte gedrag en een invoer die het probleem laat zien. Baken de wijziging af en benoem welke interface of welk gedrag behouden moet blijven. Vraag om een aangepaste implementatie en de gevallen die moeten worden gecontroleerd. Definieer bij een analytische documenttaak de vraag, vereiste velden en bronverwijzingen. Lever bij gestructureerde uitvoer een schema met duidelijke veldbetekenissen en regels voor ontbrekende waarden. Valideer zowel de syntaxis als de vraag of elke waarde uit het oorspronkelijke materiaal volgt.
Benoem bij multimodale analyse wat in elke bron van belang is. Een schermafbeelding kan een interface-uitleg ondersteunen, een PDF kan een tabel of grafiek aanleveren en een opname kan gesproken of zichtbare gebeurtenissen bevatten. De ontwikkelaarsgids bespreekt instellingen voor mediaresolutie omdat het detailniveau de verwerkte weergave en het tokengebruik beïnvloedt. De code-uitvoeringsworkflow van de maker kan aangeleverde afbeeldingen bijsnijden of uitvergroten, berekeningen uitvoeren met visuele gegevens en annotaties toevoegen voordat het model antwoordt. Leesbare kleine tekst kan een andere instelling vereisen dan een globale scènebeschrijving. Houd de relevante pagina, afbeelding of clip beschikbaar om waarnemingen te controleren; een vloeiende samenvatting bewijst niet dat elk detail correct is gelezen.
Gespreks- en toolstatus moeten in de gekozen interface behouden blijven. Gemini 3 gebruikt thought signatures om redeneercontext tussen aanroepen mee te nemen; de ontwikkelaarsgids onderscheidt beheerde gespreksgeschiedenis met status van handmatig beheerde geschiedenis zonder status. Bewaar de vereiste context wanneer je een tooltaak voortzet of een resultaat herziet. Google raadt ook aan om de standaardtemperatuur van 1.0 te behouden, in plaats van een aanpak met lage temperatuur over te nemen die bij complexe taken lussen of slechter gedrag kan veroorzaken. Dit zijn integratiepraktijken van de maker, geen nieuwe claims over het transport van een specifieke toepassing.
Het tekstmodel vermeldt geen beeld- of audiogeneratie of de Live API. De gids onderscheidt visueel begrip ook van beeldsegmentatie op pixelniveau, een mogelijkheid die Gemini 3 Flash niet ondersteunt. Kies een eindresultaat dat bij de werkelijke taak past: waarnemingen met bronverwijzingen, een gestructureerd record, een codewijziging of een beslissing met expliciete aannames. Controleer berekeningen, verifieer code in de beoogde omgeving en beoordeel teruggegeven toolinformatie. Gebruik bij recente feiten de ingestelde grounding-bronnen of actuele aangeleverde gegevens, in plaats van modelkennis als een live database te behandelen.
POST /v1/messagestextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gemini-3-flash-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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| 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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 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": "gemini-3-flash-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': 'gemini-3-flash-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': 'gemini-3-flash-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 gemini-3-flash-preview, google/gemini-3-flash-preview
/chat/completions
google/gemini-3-flash-previewGemini 3 Flash Preview combineert multimodaal begrip en redeneren met tekstuitvoer. Het ondersteunt code-, document- en beeldanalyse, gestructureerde resultaten en workflows met tools, met vier gedocumenteerde denkniveaus om de diepgang van de analyse te kiezen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Gemini 3 Flash Preview is een redeneermodel van Google voor multimodaal begrip, programmeren en agenttaken. Het accepteert tekst, afbeeldingen, video, audio en PDF en geeft tekst terug. Een verzoek kan zo geschreven instructies, bronbestanden, visuele waarnemingen en gespreksgeschiedenis rond één probleem samenbrengen. Het resultaat kan een uitleg, codevoorstel, geëxtraheerde gegevens of een op dat materiaal gebaseerd plan zijn, in plaats van een gegenereerde afbeelding of gesproken antwoord.
De modelspecifieke kaart vermeldt een invoerlimiet van 1.048.576 tokens en een uitvoerlimiet van 65.536 tokens. Plan bronmateriaal en resultaat afzonderlijk: een lang fragment uit een repository, een verzameling documenten of een opname past alleen als de verwerkte weergave en de instructies binnen het invoerbudget blijven, terwijl het antwoord nog een eigen lengtebudget nodig heeft. Geef samenhangende bronnen labels en benoem welk materiaal leidend is. Voor een lange prompt raadt de ontwikkelaarsgids aan om de concrete vraag na de gegevens te plaatsen en expliciet aan de voorafgaande informatie te koppelen.
Het denken is dynamisch; high is de gedocumenteerde standaard voor dit model. De ondersteunde niveaus zijn minimal, low, medium en high. Het zijn relatieve budgetten voor redeneren, geen gegarandeerde aantallen tokens. Minimal kan bij een lastig programmeerprobleem nog steeds enig redeneren omvatten. Kies een niveau passend bij de taak: een korte omzetting en een foutonderzoek met meerdere voorwaarden vragen om een andere aanpak. Gebruik directe, duidelijke instructies in plaats van uitgebreide redeneerrituelen af te dwingen; vraag om het uiteindelijke resultaat en de controles die het bruikbaar maken.
De kaart van de maker vermeldt gestructureerde uitvoer, function calling, code-uitvoering, computergebruik, bestandszoekfuncties, search grounding, Google Maps grounding, URL-context en caching. In de gedocumenteerde Gemini 3-werkwijze kunnen ingebouwde tools worden gecombineerd met eigen function calling. Een toepassing definieert de functies, controleert hun argumenten, voert toegestane acties uit en stuurt de resultaten terug. Voor een programmeerassistent kan een tool voor het lezen van bestanden of een gecontroleerde testrunner concreet bewijs leveren voor de volgende stap. Houd een voorgestelde actie en een waargenomen toolresultaat in het eindverslag duidelijk uit elkaar.
Geef bij programmeerwerk de relevante bestanden, taal, het verwachte gedrag en een invoer die het probleem laat zien. Baken de wijziging af en benoem welke interface of welk gedrag behouden moet blijven. Vraag om een aangepaste implementatie en de gevallen die moeten worden gecontroleerd. Definieer bij een analytische documenttaak de vraag, vereiste velden en bronverwijzingen. Lever bij gestructureerde uitvoer een schema met duidelijke veldbetekenissen en regels voor ontbrekende waarden. Valideer zowel de syntaxis als de vraag of elke waarde uit het oorspronkelijke materiaal volgt.
Benoem bij multimodale analyse wat in elke bron van belang is. Een schermafbeelding kan een interface-uitleg ondersteunen, een PDF kan een tabel of grafiek aanleveren en een opname kan gesproken of zichtbare gebeurtenissen bevatten. De ontwikkelaarsgids bespreekt instellingen voor mediaresolutie omdat het detailniveau de verwerkte weergave en het tokengebruik beïnvloedt. De code-uitvoeringsworkflow van de maker kan aangeleverde afbeeldingen bijsnijden of uitvergroten, berekeningen uitvoeren met visuele gegevens en annotaties toevoegen voordat het model antwoordt. Leesbare kleine tekst kan een andere instelling vereisen dan een globale scènebeschrijving. Houd de relevante pagina, afbeelding of clip beschikbaar om waarnemingen te controleren; een vloeiende samenvatting bewijst niet dat elk detail correct is gelezen.
Gespreks- en toolstatus moeten in de gekozen interface behouden blijven. Gemini 3 gebruikt thought signatures om redeneercontext tussen aanroepen mee te nemen; de ontwikkelaarsgids onderscheidt beheerde gespreksgeschiedenis met status van handmatig beheerde geschiedenis zonder status. Bewaar de vereiste context wanneer je een tooltaak voortzet of een resultaat herziet. Google raadt ook aan om de standaardtemperatuur van 1.0 te behouden, in plaats van een aanpak met lage temperatuur over te nemen die bij complexe taken lussen of slechter gedrag kan veroorzaken. Dit zijn integratiepraktijken van de maker, geen nieuwe claims over het transport van een specifieke toepassing.
Het tekstmodel vermeldt geen beeld- of audiogeneratie of de Live API. De gids onderscheidt visueel begrip ook van beeldsegmentatie op pixelniveau, een mogelijkheid die Gemini 3 Flash niet ondersteunt. Kies een eindresultaat dat bij de werkelijke taak past: waarnemingen met bronverwijzingen, een gestructureerd record, een codewijziging of een beslissing met expliciete aannames. Controleer berekeningen, verifieer code in de beoogde omgeving en beoordeel teruggegeven toolinformatie. Gebruik bij recente feiten de ingestelde grounding-bronnen of actuele aangeleverde gegevens, in plaats van modelkennis als een live database te behandelen.
POST /v1/chat/completionstexttext| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3-flash-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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| 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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 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 →
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-flash-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-flash-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-flash-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 gemini-3-flash-preview, google/gemini-3-flash-preview
/chat/completions
google/gemini-3-flash-previewGemini 3 Flash Preview combineert multimodaal begrip en redeneren met tekstuitvoer. Het ondersteunt code-, document- en beeldanalyse, gestructureerde resultaten en workflows met tools, met vier gedocumenteerde denkniveaus om de diepgang van de analyse te kiezen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Gemini 3 Flash Preview is een redeneermodel van Google voor multimodaal begrip, programmeren en agenttaken. Het accepteert tekst, afbeeldingen, video, audio en PDF en geeft tekst terug. Een verzoek kan zo geschreven instructies, bronbestanden, visuele waarnemingen en gespreksgeschiedenis rond één probleem samenbrengen. Het resultaat kan een uitleg, codevoorstel, geëxtraheerde gegevens of een op dat materiaal gebaseerd plan zijn, in plaats van een gegenereerde afbeelding of gesproken antwoord.
De modelspecifieke kaart vermeldt een invoerlimiet van 1.048.576 tokens en een uitvoerlimiet van 65.536 tokens. Plan bronmateriaal en resultaat afzonderlijk: een lang fragment uit een repository, een verzameling documenten of een opname past alleen als de verwerkte weergave en de instructies binnen het invoerbudget blijven, terwijl het antwoord nog een eigen lengtebudget nodig heeft. Geef samenhangende bronnen labels en benoem welk materiaal leidend is. Voor een lange prompt raadt de ontwikkelaarsgids aan om de concrete vraag na de gegevens te plaatsen en expliciet aan de voorafgaande informatie te koppelen.
Het denken is dynamisch; high is de gedocumenteerde standaard voor dit model. De ondersteunde niveaus zijn minimal, low, medium en high. Het zijn relatieve budgetten voor redeneren, geen gegarandeerde aantallen tokens. Minimal kan bij een lastig programmeerprobleem nog steeds enig redeneren omvatten. Kies een niveau passend bij de taak: een korte omzetting en een foutonderzoek met meerdere voorwaarden vragen om een andere aanpak. Gebruik directe, duidelijke instructies in plaats van uitgebreide redeneerrituelen af te dwingen; vraag om het uiteindelijke resultaat en de controles die het bruikbaar maken.
De kaart van de maker vermeldt gestructureerde uitvoer, function calling, code-uitvoering, computergebruik, bestandszoekfuncties, search grounding, Google Maps grounding, URL-context en caching. In de gedocumenteerde Gemini 3-werkwijze kunnen ingebouwde tools worden gecombineerd met eigen function calling. Een toepassing definieert de functies, controleert hun argumenten, voert toegestane acties uit en stuurt de resultaten terug. Voor een programmeerassistent kan een tool voor het lezen van bestanden of een gecontroleerde testrunner concreet bewijs leveren voor de volgende stap. Houd een voorgestelde actie en een waargenomen toolresultaat in het eindverslag duidelijk uit elkaar.
Geef bij programmeerwerk de relevante bestanden, taal, het verwachte gedrag en een invoer die het probleem laat zien. Baken de wijziging af en benoem welke interface of welk gedrag behouden moet blijven. Vraag om een aangepaste implementatie en de gevallen die moeten worden gecontroleerd. Definieer bij een analytische documenttaak de vraag, vereiste velden en bronverwijzingen. Lever bij gestructureerde uitvoer een schema met duidelijke veldbetekenissen en regels voor ontbrekende waarden. Valideer zowel de syntaxis als de vraag of elke waarde uit het oorspronkelijke materiaal volgt.
Benoem bij multimodale analyse wat in elke bron van belang is. Een schermafbeelding kan een interface-uitleg ondersteunen, een PDF kan een tabel of grafiek aanleveren en een opname kan gesproken of zichtbare gebeurtenissen bevatten. De ontwikkelaarsgids bespreekt instellingen voor mediaresolutie omdat het detailniveau de verwerkte weergave en het tokengebruik beïnvloedt. De code-uitvoeringsworkflow van de maker kan aangeleverde afbeeldingen bijsnijden of uitvergroten, berekeningen uitvoeren met visuele gegevens en annotaties toevoegen voordat het model antwoordt. Leesbare kleine tekst kan een andere instelling vereisen dan een globale scènebeschrijving. Houd de relevante pagina, afbeelding of clip beschikbaar om waarnemingen te controleren; een vloeiende samenvatting bewijst niet dat elk detail correct is gelezen.
Gespreks- en toolstatus moeten in de gekozen interface behouden blijven. Gemini 3 gebruikt thought signatures om redeneercontext tussen aanroepen mee te nemen; de ontwikkelaarsgids onderscheidt beheerde gespreksgeschiedenis met status van handmatig beheerde geschiedenis zonder status. Bewaar de vereiste context wanneer je een tooltaak voortzet of een resultaat herziet. Google raadt ook aan om de standaardtemperatuur van 1.0 te behouden, in plaats van een aanpak met lage temperatuur over te nemen die bij complexe taken lussen of slechter gedrag kan veroorzaken. Dit zijn integratiepraktijken van de maker, geen nieuwe claims over het transport van een specifieke toepassing.
Het tekstmodel vermeldt geen beeld- of audiogeneratie of de Live API. De gids onderscheidt visueel begrip ook van beeldsegmentatie op pixelniveau, een mogelijkheid die Gemini 3 Flash niet ondersteunt. Kies een eindresultaat dat bij de werkelijke taak past: waarnemingen met bronverwijzingen, een gestructureerd record, een codewijziging of een beslissing met expliciete aannames. Controleer berekeningen, verifieer code in de beoogde omgeving en beoordeel teruggegeven toolinformatie. Gebruik bij recente feiten de ingestelde grounding-bronnen of actuele aangeleverde gegevens, in plaats van modelkennis als een live database te behandelen.
POST /v1/messagestextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-3-flash-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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| 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 $0.0001 / 1K tokens Invoer · Cache schrijven $0.0001666666666666666 / 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-flash-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-flash-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-flash-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 gemini-3-flash-preview, google/gemini-3-flash-preview
/chat/completions
Technisch voorbeeld in het Engels
Keep a sorting helper immutable\n\nFix this JavaScript helper so it returns users sorted by name without changing the input array: function sortedUsers(users) { return users.sort((a,b) => a.name.localeCompare(b.name)); }. Preserve each user object. Return the revised function and tests for alphabetical order, an empty array and the unchanged original array.A revised function and three small test examples covering sorting and non-mutation.Check that the returned array is a different array and the original sequence is unchanged after the call.