This is an automated email from the ASF dual-hosted git repository.
kaxil pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new dac956c667c Document hosted OpenAI-compatible services for common.ai
(#74620)
dac956c667c is described below
commit dac956c667c36ebb38f028c34288cf6c32e09fe1
Author: Joseph Perla <[email protected]>
AuthorDate: Tue Oct 13 17:25:38 2026 -0700
Document hosted OpenAI-compatible services for common.ai (#74620)
Readers of the model providers page see how to reach self-hosted
OpenAI-compatible servers, but not that a hosted OpenAI-compatible
service uses the same connection shape with a base URL and API key.
Co-authored-by: Joseph Perla <[email protected]>
---
docs/spelling_wordlist.txt | 1 +
providers/common/ai/docs/model_providers.rst | 17 +++++++++++++++++
2 files changed, 18 insertions(+)
diff --git a/docs/spelling_wordlist.txt b/docs/spelling_wordlist.txt
index 38b1d770bbf..22ad6f3c217 100644
--- a/docs/spelling_wordlist.txt
+++ b/docs/spelling_wordlist.txt
@@ -1837,6 +1837,7 @@ triggerer
triggerers
trino
trojan
+TrustedRouter
truthy
tsql
tsv
diff --git a/providers/common/ai/docs/model_providers.rst
b/providers/common/ai/docs/model_providers.rst
index 3bff8e2360e..671712dac25 100644
--- a/providers/common/ai/docs/model_providers.rst
+++ b/providers/common/ai/docs/model_providers.rst
@@ -122,6 +122,23 @@ Any other vendor that `pydantic-ai supports
<https://ai.pydantic.dev/models/over
way: install the ``pydantic-ai-slim`` extra named on that vendor's pydantic-ai
page, create a
``pydanticai`` connection, and use the prefix from that page.
+Hosted OpenAI-compatible services
+---------------------------------
+
+A hosted service that exposes the OpenAI-compatible API is set up like a
self-hosted server:
+a ``pydanticai`` connection with the service's base URL in **Host**, its API
key in
+**Password**, and the ``openai:`` prefix on the model name. For example,
TrustedRouter is an
+OpenAI-compatible router:
+
+.. code-block:: json
+
+ {
+ "conn_type": "pydanticai",
+ "host": "https://api.trustedrouter.com/v1";,
+ "password": "<api-key>",
+ "extra": "{\"model\": \"openai:trustedrouter/auto\"}"
+ }
+
Where the model name goes
-------------------------
