OPENAI 兼容

一枚 API Key 即可接入你的应用

HanRouter 兼容 OpenAI API。优先通过 OpenAI SDK 接入；也可以携带 API Key 发送标准 HTTPS 请求。

1. 创建 API Key

在控制台创建专用 Key。Key 仅展示一次，请立即保存到环境变量，切勿写入浏览器代码或仓库。

打开 API Key 管理

2. 配置 Base URL

所有 OpenAI 兼容请求均使用此地址，并保留末尾的 /v1。

https://www.hanrouter.com/v1

3. 使用 OpenAI SDK 接入

HanRouter 兼容 OpenAI API。优先通过 OpenAI SDK 接入；也可以携带 API Key 发送标准 HTTPS 请求。

Python

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["HANROUTER_API_KEY"],
    base_url="https://www.hanrouter.com/v1",
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "Hello, HanRouter"}],
)

print(response.choices[0].message.content)

Node.js

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: process.env.HANROUTER_API_KEY,
  baseURL: "https://www.hanrouter.com/v1",
})

const response = await client.chat.completions.create({
  model: "your-model-id",
  messages: [{ role: "user", content: "Hello, HanRouter" }],
})

console.log(response.choices[0].message.content)

4. 先验证 Key 与可用模型

先查询当前 Key 可调用的模型，再将返回的模型 ID 用在对话请求中。

cURL

curl https://www.hanrouter.com/v1/models \
  -H "Authorization: Bearer $HANROUTER_API_KEY"