Pydantic AI 接入 QuickRouter 的最小示例

更新于

在 Python 中把 Pydantic AI 的 OpenAIChatModel 接到 QuickRouter,取得第一条文本回复。

先创建 QuickRouter 令牌。如果需要换模型,从模型目录复制完整 ID,并确认令牌支持对应接口。

安装并设置令牌;配置 Provider 和 Agent;运行示例并核对结果
操作路径示意。

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_KEY

Windows 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 接口。

相关文档

在线客服