接入地址与鉴权方式
OpenAI 与 Anthropic 客户端的地址区别。
地址与认证
OpenAI 兼容客户端的 Base URL 为 https://api.hanrouter.ai/v1,请求头为 Authorization: Bearer $HANROUTER_API_KEY。不要重复拼接 /v1。所有厂商都使用本站密钥,不需要向客户端填写上游厂商密钥。
Anthropic SDK 与 Claude Code 的 Base URL 使用 https://api.hanrouter.ai(不含 /v1),由客户端拼接 /v1/messages。Google 模型优先使用本站 OpenAI 兼容接口。
准备 API Key
登录 /login 后,在 /keys 创建或复制 HanRouter API Key。登录密码和浏览器登录令牌不能代替 API Key。确认密钥有效、分组允许目标模型,并在 Dashboard 查看余额。
将完整密钥保存在服务端环境变量 HANROUTER_API_KEY 中。不要放在网页代码、公开仓库或 URL 参数中。
验证可用模型
先列出当前 Key 可调用的模型,再把返回的 data[].id 原样用于请求。模型名称、大小写与别名以返回结果为准。公开模型广场仅展示有价格的模型,并不改变后台实际接入范围。
请求示例
curl "https://api.hanrouter.ai/v1/models" \
-H "Authorization: Bearer $HANROUTER_API_KEY"