Skip to main content
XRouter 同时提供 OpenAI、Anthropic Messages 和 Gemini 兼容入口。最稳妥的选择方式是先确认你使用的客户端或工具期望哪种 API 格式,再配置对应的服务地址和认证头。

快速判断

你要做什么推荐页面Base URL
在应用代码里调用聊天模型OpenAI SDKhttps://api.xrouter.dev/v1
在 Claude Code 中写代码Claude Codehttps://api.xrouter.dev
在 Codex CLI 中写代码Codex CLIhttps://api.xrouter.dev/v1
用图形界面切换 ProviderCC-Switch按工具自动或手动填写
直接调用 Anthropic Messages 格式API 参考中的 POST /v1/messageshttps://api.xrouter.dev
直接调用 Gemini 兼容格式API 参考中的 POST /v1beta/models/{model}:generateContenthttps://api.xrouter.dev
表中的地址使用公共站默认值。如果控制台显示了不同 server_address,请以控制台为准。

OpenAI 兼容入口

如果你的代码已经使用 OpenAI SDK 或 OpenAI 兼容客户端,优先选择这个入口。
https://api.xrouter.dev/v1
适合:
  • OpenAI SDK for Python、TypeScript、Go 等。
  • 支持自定义 base_urlbaseURL 的第三方工具。
  • Chat Completions、Responses、Embeddings 等 OpenAI 兼容请求。
认证方式:
Authorization: Bearer sk-your-api-key

Anthropic Messages 入口

如果客户端以 Anthropic Messages 格式发送请求,例如 Claude Code,使用这个入口。
https://api.xrouter.dev
Claude Code 会自行拼接 /v1/messages。如果你手写 HTTP 请求,完整端点是:
https://api.xrouter.dev/v1/messages
认证方式可以使用:
x-api-key: sk-your-api-key
也可以使用 Bearer token:
Authorization: Bearer sk-your-api-key

Gemini 兼容入口

如果客户端期望 Google Gemini API 格式,使用 /v1beta/models/... 路径。
https://api.xrouter.dev/v1beta/models/{model}:generateContent
推荐使用请求头传递密钥:
x-goog-api-key: sk-your-api-key
部分 Gemini 客户端只支持 key 查询参数,XRouter 也兼容这种形式:
https://api.xrouter.dev/v1beta/models/{model}:generateContent?key=sk-your-api-key
查询参数更容易出现在日志、浏览器历史或代理记录中。只在客户端无法设置请求头时使用 key 查询参数。

工具接入入口

Claude Code

使用 Anthropic Messages 兼容格式,适合 Claude Code 用户。

Codex CLI

使用 OpenAI Responses API,适合终端智能体式编码。

CC-Switch

用桌面图形界面管理 Claude、Codex 和 Gemini Provider。

OpenAI SDK

应用代码里最通用的接入方式。