[{"data":1,"prerenderedAt":45},["ShallowReactive",2],{"docs:providers/google":3},{"title":4,"navTitle":4,"description":5,"api":6,"html":7,"toc":8,"path":34,"tab":35,"group":36,"prev":37,"next":40,"markdownUrl":43,"sourceUrl":44,"lastModified":6},"@standardagents/google","Google Gemini and Imagen provider package for Standard Agents using the official @google/genai SDK",null,"\u003Caside class=\"docs-callout\" data-kind=\"info\" role=\"note\">\u003Cp>For direct access, set \u003Ccode>GOOGLE_API_KEY\u003C/code> in your environment. Standard Agents Builder can use hosted routing through \u003Ccode>STANDARD_AGENTS_API_KEY\u003C/code> when the provider key is absent. Hosted access depends on platform configuration.\u003C/p>\u003C/aside>\n\u003Ch2 id=\"overview\">\u003Ca class=\"docs-anchor\" href=\"#overview\" aria-label=\"Link to this section\">\u003C/a>Overview\u003C/h2>\n\u003Cp>The \u003Ccode>@standardagents/google\u003C/code> package provides a Standard Agents provider for Google's Gemini and Imagen APIs. It uses the official \u003Ccode>@google/genai\u003C/code> SDK, supports Gemini text/tool/image requests, and routes Imagen generation and editing through Google's dedicated image endpoints.\u003C/p>\n\u003Cdiv class=\"docs-card\">\u003Cspan class=\"docs-icon\" data-icon=\"sparkles\">\u003C/span>\u003Cspan class=\"docs-card-title\">Key Features\u003C/span>\u003Cdiv class=\"docs-card-body\">\u003Cul>\n\u003Cli>Official \u003Ccode>@google/genai\u003C/code> SDK integration\u003C/li>\n\u003Cli>Gemini text, multimodal, JSON, streaming, and tool calling support\u003C/li>\n\u003Cli>Gemini thought-signature preservation for multi-step tool calling\u003C/li>\n\u003Cli>Imagen image generation and edit support\u003C/li>\n\u003Cli>Built-in pricing for documented Gemini models used in request logs\u003C/li>\n\u003Cli>Public model discovery through \u003Ccode>models.list()\u003C/code>\u003C/li>\n\u003C/ul>\u003C/div>\u003C/div>\n\u003Ch2 id=\"installation\">\u003Ca class=\"docs-anchor\" href=\"#installation\" aria-label=\"Link to this section\">\u003C/a>Installation\u003C/h2>\n\u003Cfigure class=\"docs-code\" data-docs=\"code\" data-lang=\"bash\">\u003Cfigcaption class=\"docs-code-title\">pnpm\u003C/figcaption>\u003Cpre class=\"shiki shiki-themes one-light github-dark\" style=\"--shiki-light:#383A42;--shiki-dark:#e1e4e8;--shiki-light-bg:#FAFAFA;--shiki-dark-bg:#24292e\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#4078F2;--shiki-dark:#B392F0\">pnpm\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\"> add\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\"> @standardagents/google\u003C/span>\u003C/span>\u003C/code>\u003C/pre>\u003C/figure>\n\u003Ch2 id=\"quick-start\">\u003Ca class=\"docs-anchor\" href=\"#quick-start\" aria-label=\"Link to this section\">\u003C/a>Quick Start\u003C/h2>\n\u003Cfigure class=\"docs-code\" data-docs=\"code\" data-lang=\"typescript\">\u003Cpre class=\"shiki shiki-themes one-light github-dark\" style=\"--shiki-light:#383A42;--shiki-dark:#e1e4e8;--shiki-light-bg:#FAFAFA;--shiki-dark-bg:#24292e\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#A626A4;--shiki-dark:#F97583\">import\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\"> { \u003C/span>\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">defineModel\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\"> } \u003C/span>\u003Cspan style=\"--shiki-light:#A626A4;--shiki-dark:#F97583\">from\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\"> '@standardagents/spec'\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">;\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#A626A4;--shiki-dark:#F97583\">import\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\"> { \u003C/span>\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">google\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\"> } \u003C/span>\u003Cspan style=\"--shiki-light:#A626A4;--shiki-dark:#F97583\">from\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\"> '@standardagents/google'\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">;\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#A626A4;--shiki-dark:#F97583\">export\u003C/span>\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#F97583\"> default\u003C/span>\u003Cspan style=\"--shiki-light:#4078F2;--shiki-dark:#B392F0\"> defineModel\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">({\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">  name\u003C/span>\u003Cspan style=\"--shiki-light:#0184BC;--shiki-dark:#E1E4E8\">:\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\"> 'gemini-fast'\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">,\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">  provider\u003C/span>\u003Cspan style=\"--shiki-light:#0184BC;--shiki-dark:#E1E4E8\">:\u003C/span>\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\"> google\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">,\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">  model\u003C/span>\u003Cspan style=\"--shiki-light:#0184BC;--shiki-dark:#E1E4E8\">:\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\"> 'gemini-3.8-flash'\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">,\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">  providerOptions\u003C/span>\u003Cspan style=\"--shiki-light:#0184BC;--shiki-dark:#E1E4E8\">:\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\"> {\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">    responseModalities\u003C/span>\u003Cspan style=\"--shiki-light:#0184BC;--shiki-dark:#E1E4E8\">:\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\"> [\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\">'TEXT'\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">],\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">  },\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#E1E4E8\">});\u003C/span>\u003C/span>\u003C/code>\u003C/pre>\u003C/figure>\n\u003Ch2 id=\"common-models\">\u003Ca class=\"docs-anchor\" href=\"#common-models\" aria-label=\"Link to this section\">\u003C/a>Common Models\u003C/h2>\n\u003Cul>\n\u003Cli>\u003Ccode>gemini-3.1-pro-preview\u003C/code>\u003C/li>\n\u003Cli>\u003Ccode>gemini-3.8-flash\u003C/code>\u003C/li>\n\u003Cli>\u003Ccode>gemini-2.5-flash-lite\u003C/code>\u003C/li>\n\u003Cli>\u003Ccode>gemini-2.5-flash-image\u003C/code>\u003C/li>\n\u003Cli>\u003Ccode>gemini-3-pro-image-preview\u003C/code>\u003C/li>\n\u003Cli>\u003Ccode>imagen-4.0-generate-001\u003C/code>\u003C/li>\n\u003Cli>\u003Ccode>imagen-3.0-capability-001\u003C/code>\u003C/li>\n\u003C/ul>\n\u003Ch2 id=\"provider-options\">\u003Ca class=\"docs-anchor\" href=\"#provider-options\" aria-label=\"Link to this section\">\u003C/a>Provider Options\u003C/h2>\n\u003Cp>Common Gemini options include \u003Ccode>responseModalities\u003C/code>, \u003Ccode>candidateCount\u003C/code>, \u003Ccode>cachedContent\u003C/code>, \u003Ccode>thinkingConfig\u003C/code>, \u003Ccode>imageConfig\u003C/code>, and \u003Ccode>safetySettings\u003C/code>.\u003C/p>\n\u003Cp>Common Imagen options include \u003Ccode>numberOfImages\u003C/code>, \u003Ccode>negativePrompt\u003C/code>, \u003Ccode>aspectRatio\u003C/code>, \u003Ccode>outputMimeType\u003C/code>, \u003Ccode>imageSize\u003C/code>, and \u003Ccode>editMode\u003C/code>.\u003C/p>\n\u003Ch2 id=\"tool-result-images\">\u003Ca class=\"docs-anchor\" href=\"#tool-result-images\" aria-label=\"Link to this section\">\u003C/a>Tool Result Images\u003C/h2>\n\u003Cp>The Google provider preserves Standard Agents' internal tool-result message structure and only rewrites the outbound Google request:\u003C/p>\n\u003Cul>\n\u003Cli>Gemini 3 series models keep image tool results nested in \u003Ccode>functionResponse.parts\u003C/code>\u003C/li>\n\u003Cli>Older Google chat models get a text-only \u003Ccode>functionResponse\u003C/code>, with the image emitted as a sibling inline image part instead\u003C/li>\n\u003C/ul>\n\u003Cp>This keeps provider fallbacks and log storage provider-agnostic while still working around older Google models that reject multimodal \u003Ccode>functionResponse\u003C/code> payloads.\u003C/p>\n\u003Ch2 id=\"pricing\">\u003Ca class=\"docs-anchor\" href=\"#pricing\" aria-label=\"Link to this section\">\u003C/a>Pricing\u003C/h2>\n\u003Cp>The provider includes built-in pricing for documented Gemini models such as \u003Ccode>gemini-2.5-pro\u003C/code>, \u003Ccode>gemini-2.5-flash\u003C/code>, \u003Ccode>gemini-2.5-flash-lite\u003C/code>, \u003Ccode>gemini-2.5-flash-image\u003C/code>, and \u003Ccode>gemini-3-pro-image-preview\u003C/code>.\u003C/p>\n\u003Cp>The provider also includes per-image pricing for Imagen 4 generation variants and \u003Ccode>imagen-3.0-capability-001\u003C/code>. For models without bundled pricing, set prices on your model definition.\u003C/p>\n\u003Ch2 id=\"environment-setup\">\u003Ca class=\"docs-anchor\" href=\"#environment-setup\" aria-label=\"Link to this section\">\u003C/a>Environment Setup\u003C/h2>\n\u003Cfigure class=\"docs-code\" data-docs=\"code\" data-lang=\"bash\">\u003Cfigcaption class=\"docs-code-title\">.dev.vars\u003C/figcaption>\u003Cpre class=\"shiki shiki-themes one-light github-dark\" style=\"--shiki-light:#383A42;--shiki-dark:#e1e4e8;--shiki-light-bg:#FAFAFA;--shiki-dark-bg:#24292e\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E45649;--shiki-dark:#E1E4E8\">GOOGLE_API_KEY\u003C/span>\u003Cspan style=\"--shiki-light:#383A42;--shiki-dark:#F97583\">=\u003C/span>\u003Cspan style=\"--shiki-light:#50A14F;--shiki-dark:#9ECBFF\">...\u003C/span>\u003C/span>\u003C/code>\u003C/pre>\u003C/figure>",[9,13,16,19,22,25,28,31],{"id":10,"text":11,"depth":12},"overview","Overview",2,{"id":14,"text":15,"depth":12},"installation","Installation",{"id":17,"text":18,"depth":12},"quick-start","Quick Start",{"id":20,"text":21,"depth":12},"common-models","Common Models",{"id":23,"text":24,"depth":12},"provider-options","Provider Options",{"id":26,"text":27,"depth":12},"tool-result-images","Tool Result Images",{"id":29,"text":30,"depth":12},"pricing","Pricing",{"id":32,"text":33,"depth":12},"environment-setup","Environment Setup","providers/google","docs","Providers",{"path":38,"title":39,"navTitle":39},"providers/deepinfra","@standardagents/deepinfra",{"path":41,"title":42,"navTitle":42},"providers/groq","@standardagents/groq","/docs/providers/google.md","https://github.com/standardagents/agentbuilder/blob/main/docs/providers/google.mdx",1794580509816]