Pydantic AI 接入 QuickRouter 的最小示例
在 Python 中把 Pydantic AI 的 OpenAIChatModel 接到 QuickRouter,取得第一条文本回复。
先创建 QuickRouter 令牌。如果需要换模型,从模型目录复制完整 ID,并确认令牌支持对应接口。

1. 安装并设置令牌
python -m pip install -U pydantic-ai在启动应用的终端设置令牌。macOS / Linux 的 Bash 或 zsh 可运行下面命令,按提示输入自己的密钥。
printf 'QuickRouter API Key: '; read -rs QUICKROUTER_API_KEY; printf '\n'
export QUICKROUTER_API_KEYWindows PowerShell 7.2+ 可用 $env:QUICKROUTER_API_KEY = Read-Host -MaskInput "QuickRouter API Key"。
2. 配置 Provider 和 Agent
保存为 quickrouter_agent.py。示例使用 OpenAIChatModel 和文本输出。
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider
provider = OpenAIProvider(
base_url="https://api.quickrouter.ai/v1",
api_key=os.environ["QUICKROUTER_API_KEY"],
)
model = OpenAIChatModel("gpt-4o-mini", provider=provider)
agent = Agent(model, instructions="请用简洁的中文回答。")
result = agent.run_sync("请只回复 OK。")
print(result.output)3. 运行示例并核对结果
执行 python quickrouter_agent.py。收到文本后,在QuickRouter 使用日志核对时间和模型 ID。
常见问题
- 环境变量 KeyError。确认变量设置在运行脚本的进程环境中。
- 404 或模型不可用。确认地址以
/v1结尾,且令牌支持所选模型的 Chat Completions 接口。