Skip to content
全部文章

面向 pi coding agent 的官方 AnyRouter provider

官方 pi 扩展把 AnyRouter 注册为 provider,刷新实时目录,并设置兼容标志,而不是让 pi 去猜。一把 sk-ar-v1- key,覆盖目录里的每一个聊天模型。

扩展做什么

Pi 从 ~/.pi/agent/models.json 读取自定义的 OpenAI 兼容 provider。手工编辑这个文件可用,但模型列表会在新增或下架模型当天就过期。

官方扩展把 anyrouter 注册为 provider,并从 https://anyrouter.dev/api/v1 刷新目录,所以 pi 里的 /model 列出的是 AnyRouter 当天能路由的模型。它把流式请求交给 pi 内置的 openai-completions 实现,所以工具调用、用量统计和取消都保持可用。

安装

两个选项。想要实时目录就用扩展,想要最短路径就用 AnyRouter CLI:

从 npm 或 git 安装扩展,或使用 AnyRouter CLI。
pi install npm:@anyr/pi

# 或者从 git
pi install git:github.com/AnyRouterHQ/pi-anyrouter

# 或者,使用 AnyRouter CLI
curl -fsSL https://anyr.dev/cli.sh | bash
anyr pi

扩展已发布到 npm 的 @anyr scope,名为 @anyr/pi,所以 pi install npm:@anyr/pi 就是简写形式。CLI 会写入 provider、设置 ANYROUTER_API_KEY 并启动 pi --provider anyrouter,当你不想自己管文件时这是最快的路径。源码、测试和协议限制都在 AnyRouterHQ/pi-anyrouter。

兼容标志为什么重要

Pi 根据 host 决定如何与 provider 通信。对未知 host,它会假设一个标准 OpenAI 端点,发送 store、在推理模型上使用 developer 角色、max_completion_tokens 以及很长的 prompt 缓存保留期。

AnyRouter 的 chat 端点没有文档化这些字段。扩展改为根据每个目录行设置 pi 的 compat 标志,所以请求只发送模型实际列出的参数。列出 reasoning_effort 的行发送它,列出 reasoning 的行发送 reasoning 对象,两者都不列的行完全不发送 reasoning 字段。

它不做什么

这个 provider 使用 chat completions 协议。Claude Code 自己的请求形状是 Anthropic Messages,pi 可以用 anthropic-messages 客户端发出,但那个客户端还会发送 Claude 专属字段,这些字段未针对本目录的其余模型验证,所以没有注册第二个 provider。Codex 的形状是 Responses API,而 pi 的 Codex 客户端面向 ChatGPT 后端,不是这个网关。

两者仍然可以通过 chat completions 与它们的模型 id 一起工作,AnyRouter 接受这些 id。

需要知道

目录请求按 API key 缓存五分钟,与响应的 max-age 一致,离线刷新不会访问网络。免费模型在 Go 及以上套餐每 token $0,没有每日上限,BYOK 路由不加价。

Pi 不支持 MCP,所以没有可自动连接的东西。

选一个套餐,马上开始

Go 每月 $2,得 $4 额度。

Pro 每月 $10,得 $20 额度。

Pro+ 每月 $45,得 $100 额度。

Max 每月 $100,得 $300 额度。

注册后在下一页付款,即可调用模型。