GatewayAgent Frameworks

Google ADK (gateway)

Route Google ADK’s underlying LLM calls through the Respan gateway to use 250+ models from different providers. The examples use ADK’s LiteLlm adapter and load keys from the repo root .env.

Setup

1

Install packages

$pip install "google-adk[extensions]"
2

Set environment variables

$export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"
$export RESPAN_BASE_URL="https://api.respan.ai/api"
$export RESPAN_MODEL="openai/gpt-5-mini"

Use RESPAN_BASE_URL only if you are calling a non-production Respan gateway.

3

Point Google ADK to the Respan gateway

Use LiteLlm with the OpenAI-compatible Respan endpoint to route ADK’s LLM calls.

1import os
2from google.adk.agents import Agent
3from google.adk.models.lite_llm import LiteLlm
4
5model_name = os.getenv("RESPAN_MODEL", "openai/gpt-5-mini")
6
7agent = Agent(
8    name="assistant",
9    model=LiteLlm(
10        model=model_name,
11        api_key=os.environ["RESPAN_API_KEY"],
12        api_base=os.getenv("RESPAN_BASE_URL", "https://api.respan.ai/api"),
13    ),
14    instruction="You are a concise assistant.",
15)

Switch models

Use another OpenAI model ID through ADK’s LiteLLM adapter.

1LiteLlm(model="openai/gpt-5-mini", api_key=..., api_base="https://api.respan.ai/api")
2LiteLlm(model="openai/gpt-5.5", api_key=..., api_base="https://api.respan.ai/api")

ADK’s LiteLlm adapter uses LiteLLM provider namespaces. This page avoids showing Gemini behind an openai/ prefix; use the Google GenAI gateway page for native Gemini examples or the Respan API/OpenAI SDK pages for provider-neutral model IDs.

See the full model list.