Google Gemini provider – built on the OpenAI baseline defaults with Gemini-specific customizations.

Implementation

Uses built-in defaults with custom encoding/decoding to translate between OpenAI format and Gemini API format.

Google-Specific Extensions

Beyond standard OpenAI parameters, Google supports:

• google_api_version - Select API version ("v1" or "v1beta"). Defaults to "v1" for production stability. Set to "v1beta" to enable beta features like Google Search grounding.
• google_safety_settings - List of safety filter configurations
• google_candidate_count - Number of response candidates to generate (default: 1)
• google_grounding - Enable Google Search grounding (built-in web search). Requires google_api_version: "v1beta"
• google_thinking_budget - Thinking token budget for Gemini 2.5 models
• dimensions - Number of dimensions for embedding vectors
• task_type - Task type for embeddings (e.g., RETRIEVAL_QUERY)

See provider_schema/0 for the complete Google-specific schema and ReqLLM.Provider.Options for inherited OpenAI parameters.

API Version Selection

The provider defaults to Google's v1beta API which supports all features including function calling (tools) and Google Search grounding. For legacy compatibility, you can force v1 by setting google_api_version: "v1", but note that v1 does not support function calling or grounding:

ReqLLM.generate_text(
  "google:gemini-2.5-flash",
  "What are today's tech headlines?",
  provider_options: [
    google_grounding: %{enable: true}
  ]
)

Note: Setting google_api_version: "v1" with function calling (tools) or grounding will return an error.

Configuration

# Add to .env file (automatically loaded)
GOOGLE_API_KEY=AIza...