apply suggested changes

Author: laisbsc

docs/ai_gateway/gateway.md

@@ -1,6 +1,6 @@
 # Pydantic AI Gateway
 
-**Pydantic AI Gateway** (PAIG) is a unified interface for accessing multiple AI providers with a single key. Features include built-in OpenTelemetry observability, real-time cost monitoring, failover management , and native integration with the Pydantic stack.
+**Pydantic AI Gateway** (PAIG) is a unified interface for accessing multiple AI providers with a single key. Features include built-in OpenTelemetry observability, real-time cost monitoring, failover management, and native integration with the Pydantic stack.
 
 !!! note "Free while in Beta"
     The Pydantic AI Gateway is currently in Beta. You can bring your own key (BYOK) or buy inference through the Gateway (we will eat the card fee for now).
@@ -11,24 +11,22 @@ For questions and feedback, contact us on [Slack](https://logfire.pydantic.dev/d
 
 ## Documentation Integration
 
-To help you get started with [Pydantic AI Gateway](https://gateway.pydantic.dev), most code examples throughout the Pydantic AI docs include a "Pydantic AI Gateway" tab alongside the standard Pydantic AI call string named here "Direct to Provider API" tab. This allows you to see how to adapt examples for Gateway usage by simply switching tabs.
-
-The main difference is that when using Gateway, model strings use the `gateway/` prefix.
+To help you get started with [Pydantic AI Gateway](https://gateway.pydantic.dev), some code examples on the Pydantic AI documentation include a "Via Pydantic AI Gateway" tab, alongside a "Direct to Provider API" tab with the standard Pydantic AI model string.  The main difference between them is that when using Gateway, model strings use the `gateway/` prefix.
 
 ## Key features
 - **API key management**: access multiple LLM providers with a single Gateway key.
 - **Cost Limits**: set spending limits at project, user, and API key levels with daily, weekly, and monthly caps.
-- **BYOK and managed providers:** Bring your own API keys (BYOK) from LLM providers, or pay for API usage directly through the platform (_coming soon_).
+- **BYOK and managed providers:** Bring your own API keys (BYOK) from LLM providers, or pay for inference directly through the platform.
 - **Multi-provider support:** Access models from OpenAI, Anthropic, Google Vertex, Groq, and AWS Bedrock. _More providers coming soon_.
 - **Backend observability:** Log every request through [Pydantic Logfire](https://pydantic.dev/logfire) or any OpenTelemetry backend (_coming soon_).
 - **Zero translation**: Unlike traditional AI gateways that translate everything to one common schema, PAIG allows requests to flow through directly in each provider's native format. This gives you immediate access to the new model features as soon as they are released.
 - **Open source with self-hosting**: PAIG's core is [open source](https://github.com/pydantic/pydantic-ai-gateway/) (under [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.en.html)), allowing self-hosting with file-based configuration, instead of using the managed service.
 - **Enterprise ready**: Includes SSO (with OIDC support), granular permissions, and flexible deployment options. Deploy to your Cloudflare account, or run on-premises with our [consulting support](https://pydantic.dev/contact).
 
-```python {title="hello_world.py" test="skip"}
+```python {title="hello_world.py"}
 from pydantic_ai import Agent
 
-agent = Agent('gateway/chat:gpt-4.1')
+agent = Agent('gateway/chat:gpt-5')
 
 result = agent.run_sync('Where does "hello world" come from?')
 print(result.output)

mkdocs.yml

@@ -24,7 +24,7 @@ nav:
           - message-history.md
           - direct.md
       - Models & Providers:
-          - Overview: models/gateway.md
+          - Overview: models/overview.md
           - models/openai.md
           - models/anthropic.md
           - models/google.md
@@ -63,7 +63,7 @@ nav:
           - Quick Start: evals/quick-start.md
           - Core Concepts: evals/core-concepts.md
       - Evaluators:
-          - Overview: evals/evaluators/gateway.md
+          - Overview: evals/evaluators/overview.md
           - Built-in Evaluators: evals/evaluators/built-in.md
           - LLM Judge: evals/evaluators/llm-judge.md
           - Custom Evaluators: evals/evaluators/custom.md
@@ -90,12 +90,12 @@ nav:
   - Integrations:
       - Debugging & Monitoring with Pydantic Logfire: logfire.md
       - Durable Execution:
-        - Overview: durable_execution/gateway.md
+        - Overview: durable_execution/overview.md
         - Temporal: durable_execution/temporal.md
         - DBOS: durable_execution/dbos.md
         - Prefect: durable_execution/prefect.md
       - UI Event Streams:
-        - Overview: ui/gateway.md
+        - Overview: ui/overview.md
         - AG-UI: ui/ag-ui.md
         - Vercel AI: ui/vercel-ai.md
       - Agent2Agent (A2A): a2a.md

tests/test_examples.py

@@ -179,6 +179,7 @@ def print(self, *args: Any, **kwargs: Any) -> None:
     env.set('MOONSHOTAI_API_KEY', 'testing')
     env.set('DEEPSEEK_API_KEY', 'testing')
     env.set('OVHCLOUD_API_KEY', 'testing')
+    env.set('PYDANTIC_AI_GATEWAY_API_KEY', 'testing')
 
     prefix_settings = example.prefix_settings()
     opt_test = prefix_settings.get('test', '')