From f52faccb53f13f206f422e82bb5c256e76ff1888 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20Lochm=C3=BCller?= <tim@fruit-lab.de>
Date: Sat, 22 Nov 2025 13:52:48 +0100
Subject: [PATCH] feat: Add OpenRouter documentation and examples

---
 docs/components/platform.rst                  | 14 ++++----
 examples/openrouter/chat-gemini-websearch.php | 32 +++++++++++++++++
 examples/openrouter/set-app-title-and-url.php | 35 +++++++++++++++++++
 3 files changed, 75 insertions(+), 6 deletions(-)
 create mode 100644 examples/openrouter/chat-gemini-websearch.php
 create mode 100644 examples/openrouter/set-app-title-and-url.php

diff --git a/docs/components/platform.rst b/docs/components/platform.rst
index af881a340..b694403ae 100644
--- a/docs/components/platform.rst
+++ b/docs/components/platform.rst
@@ -109,21 +109,22 @@ Supported Models & Platforms
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 * **Language Models**
-    * `OpenAI's GPT`_ with `OpenAI`_ and `Azure`_ as Platform
+    * `OpenAI's GPT`_ with `OpenAI`_, `Azure`_ and `OpenRouter`_ as Platform
     * `Anthropic's Claude`_ with `Anthropic`_ and `AWS Bedrock`_ as Platform
-    * `Meta's Llama`_ with `Azure`_, `Ollama`_, `Replicate`_ and `AWS Bedrock`_ as Platform
+    * `Meta's Llama`_ with `Azure`_, `Ollama`_, `Replicate`_, `AWS Bedrock`_ and `OpenRouter`_ as Platform
     * `Gemini`_ with `Google`_, `Vertex AI`_ and `OpenRouter`_ as Platform
     * `Vertex AI Gen AI`_ with `Vertex AI`_ as Platform
     * `DeepSeek's R1`_ with `OpenRouter`_ as Platform
     * `Amazon's Nova`_ with `AWS Bedrock`_ as Platform
-    * `Mistral's Mistral`_ with `Mistral`_ as Platform
+    * `Mistral's Mistral`_ with `Mistral`_ and `OpenRouter`_ as Platform
     * `Albert API`_ models with `Albert`_ as Platform (French government's sovereign AI gateway)
 * **Embeddings Models**
-    * `Gemini Text Embeddings`_ with `Google`_
+    * `Gemini Text Embeddings`_ with `Google`_ and `OpenRouter`_
     * `Vertex AI Text Embeddings`_ with `Vertex AI`_
-    * `OpenAI's Text Embeddings`_ with `OpenAI`_ and `Azure`_ as Platform
+    * `OpenAI's Text Embeddings`_ with `OpenAI`_, `Azure`_ and `OpenRouter`_ as Platform
     * `Voyage's Embeddings`_ with `Voyage`_ as Platform
-    * `Mistral Embed`_ with `Mistral`_ as Platform
+    * `Mistral Embed`_ with `Mistral`_ and `OpenRouter`_ as Platform
+    * `Qwen`_ with `OpenRouter`_ as Platform
 * **Other Models**
     * `OpenAI's Dall·E`_ with `OpenAI`_ as Platform
     * `OpenAI's Whisper`_ with `OpenAI`_ and `Azure`_ as Platform
@@ -507,6 +508,7 @@ Code Examples
 .. _`DeepSeek's R1`: https://www.deepseek.com/
 .. _`Amazon's Nova`: https://nova.amazon.com
 .. _`Mistral's Mistral`: https://www.mistral.ai/
+.. _`Qwen`: https://qwen.ai/
 .. _`Albert API`: https://github.com/etalab-ia/albert-api
 .. _`Albert`: https://alliance.numerique.gouv.fr/produit/produits-interminist%C3%A9rielles/albert-api/
 .. _`Mistral`: https://www.mistral.ai/
diff --git a/examples/openrouter/chat-gemini-websearch.php b/examples/openrouter/chat-gemini-websearch.php
new file mode 100644
index 000000000..336b8944c
--- /dev/null
+++ b/examples/openrouter/chat-gemini-websearch.php
@@ -0,0 +1,32 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+use Symfony\AI\Platform\Bridge\OpenRouter\PlatformFactory;
+use Symfony\AI\Platform\Message\Message;
+use Symfony\AI\Platform\Message\MessageBag;
+
+require_once dirname(__DIR__).'/bootstrap.php';
+
+$platform = PlatformFactory::create(env('OPENROUTER_KEY'), http_client());
+
+$messages = new MessageBag(
+    Message::forSystem('Check the web for details that the user ask.'),
+    Message::ofUser('Who win the Formula1 GP in Brasilia at 2025-11-09?'),
+);
+
+// ":online" add web search tooling to the OpenRouter model
+$result = $platform->invoke('google/gemini-2.5-flash-lite:online', $messages);
+
+// Example result:
+// Lando Norris won the Formula 1 Grand Prix in Brasilia on November 9, 2025. This victory significantly extended his lead
+// in the Drivers' Championship [planetf1.com]. Max Verstappen finished third after starting from the pit lane [motorsportweek.com].
+
+echo $result->asText().\PHP_EOL;
diff --git a/examples/openrouter/set-app-title-and-url.php b/examples/openrouter/set-app-title-and-url.php
new file mode 100644
index 000000000..e571138d7
--- /dev/null
+++ b/examples/openrouter/set-app-title-and-url.php
@@ -0,0 +1,35 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+use Symfony\AI\Platform\Bridge\OpenRouter\PlatformFactory;
+use Symfony\AI\Platform\Message\Message;
+use Symfony\AI\Platform\Message\MessageBag;
+
+require_once dirname(__DIR__).'/bootstrap.php';
+
+// Set title AND uri to track the calls in the OpenRouter Activity feed
+$client = http_client()->withOptions([
+    'headers' => [
+        'HTTP-Referer' => 'https://ai.symfony.com/',
+        'X-Title' => 'My Special Symfony AI App',
+    ],
+]);
+
+$platform = PlatformFactory::create(env('OPENROUTER_KEY'), $client);
+
+$messages = new MessageBag(
+    Message::forSystem('Output two sentences related to the user topic.'),
+    Message::ofUser('Chess'),
+);
+
+$result = $platform->invoke('google/gemini-2.5-flash-lite', $messages);
+
+echo $result->asText().\PHP_EOL;