Google AI Studio
Adapter key googleaistudio. Strict tools, embeddings routes, and image thinking.
{ "publicModel": "gemini", "adapterKey": "googleaistudio", "upstreamModel": "gemini-3-pro", "credentials": { "apiKey": "..." } }- Credentials:
apiKeyonly. - Default transport:
generateContentfor text and image operations,generate_videosfor Veo video generation, andembedContent/batchEmbedContentsfor embeddings. - Tool schemas are translated, not passed through. Non-strict tools and pre-Gemini-3 models use
Gemini's OpenAPI-shaped
parametersfield and its narrower schema translator. On Gemini 3 and later, a request containing an OpenAIstrict: truefunction instead usesparametersJsonSchemafor that function and enables Gemini's schema-constrainedVALIDATEDmode when the tool choice remains optional. Required or named tool choices keepANY, which already constrains arguments to the function schema. This is generation-time enforcement; the gateway does not coerce arguments or retry a hidden repair request. Constructs outside Google's supported schema subset may still require a simpler tool definition. - Reasoning:
gemini_level(discretethinkingLevel, withxhighmapped tohigh) orgemini_budget(rawthinkingBudgettokens), per model — see Reasoning. - Thought signatures round-trip statelessly inside the tool call id. When Gemini returns a
thoughtSignatureon a function call, the gateway embeds it in the public tool call id as<id>__thought__<signature>(LiteLLM-compatible) across all three surfaces. Any client that echoes tool call ids verbatim — every standard OpenAI/Anthropic client, including the Vercel AI SDK — round-trips it with no changes and no server-side state. The signature is also mirrored asprovider_specific_fields.thought_signatureandextra_content.google.thought_signatureon the rendered tool call, and all three inbound forms are accepted. See Provider-specific fields. - Embeddings accept text input and float vectors only through this gateway — no tokenized input,
no
base64encoding — regardless of what the catalog profile might otherwise allow. - Image
qualitymaps to native thinking for Gemini image models:auto(or omitted) andlowusethinkingLevel: minimal;highusesthinkingLevel: high. Some image models expose onlyquality: auto. See Images. - Veo uses the Gemini
:predictLongRunningREST flow. Image/video references must be data URLs because the REST request sends them asinlineData; multiple image references are forwarded asreferenceImages, whilevideo_urlis used for Veo extension on models that declare it. - Catalog:
src/adapters/google/catalog.json(folder isgoogle; adapter key isgoogleaistudio— the one place today those two names don't match).
What to read next
- Reasoning —
gemini_level/gemini_budgetin detail. - Embeddings — the reduced Google embedding contract.
- Images — the quality-to-thinking mapping.
- Videos — the async video lifecycle and object storage.