5 分钟发出第一个请求

登录、创建 API Key、查询模型并发起请求。

准备 API Key

登录 /login 后,在 /keys 创建或复制 HanRouter API Key。登录密码和浏览器登录令牌不能代替 API Key。确认密钥有效、分组允许目标模型,并在 Dashboard 查看余额。

将完整密钥保存在服务端环境变量 HANROUTER_API_KEY 中。不要放在网页代码、公开仓库或 URL 参数中。

地址与认证

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 兼容接口。

验证可用模型

先列出当前 Key 可调用的模型,再把返回的 data[].id 原样用于请求。模型名称、大小写与别名以返回结果为准。公开模型广场仅展示有价格的模型,并不改变后台实际接入范围。

请求示例
curl "https://api.hanrouter.ai/v1/models" \
  -H "Authorization: Bearer $HANROUTER_API_KEY"

调用模型

安装 openai 包,将 HANROUTER_MODEL 设置为上一接口返回的模型 ID,然后运行示例。

请求示例
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HANROUTER_API_KEY"],
    base_url="https://api.hanrouter.ai/v1",
)
model_id = os.environ["HANROUTER_MODEL"]
result = client.chat.completions.create(
    model=model_id,
    messages=[{"role": "user", "content": "Hello"}],
)
print(result.choices[0].message.content)

相关文章

创建与管理 API Key ›