跳转到主要内容
HaiToken 大模型网关兼容 OpenAI 和 Anthropic Claude 主流 API 协议,你只需三步即可完成接入:获取 API Key、调用 API、接入 AI 工具。

第一步:获取 API Key

  1. 注册并登录 HaiToken 控制台
  2. 进入左侧菜单 令牌管理
  3. 点击 创建 API Key,填写名称后生成密钥
  4. 复制并妥善保存生成的 API Key(仅创建时可见一次)
请妥善保管 API Key,不要在客户端代码或公开仓库中暴露密钥。

第二步:调用 API

HaiToken 提供两种接口格式,你可以根据使用的模型选择对应的接入方式。

OpenAI 格式

适用于 OpenAI 系列模型,兼容 POST /v1/chat/completions 协议。
import requests

url = "https://api.haitoken.ai/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "gpt-4o",
    "messages": [
        {"role": "user", "content": "你好,请介绍一下自己"}
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

Claude 格式

适用于 Anthropic Claude 系列模型,兼容 POST /v1/messages 协议。
调用 Claude 格式接口时,需要在请求头中额外携带 anthropic-version,推荐值为 2023-06-01
import requests

url = "https://api.haitoken.ai/v1/messages"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "anthropic-version": "2023-06-01"
}
data = {
    "model": "claude-sonnet-4-0",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "你好,请介绍一下自己"}
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

第三步:接入常用 AI 工具

获取 API Key 并验证 API 可用后,你可以将 HaiToken 网关接入常用 AI 编程工具。

Cursor

  1. 打开 Cursor,进入 Settings > Models
  2. OpenAI API Key 处填入你的 API Key
  3. OpenAI Base URL 设置为 https://api.haitoken.ai/v1
  4. 保存后即可在模型列表中选择支持的模型

Claude Code

  1. 在终端中设置环境变量:
export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://api.haitoken.ai"
  1. 启动 Claude Code 即可使用。

Open Code

  1. 在 OpenCode TUI 中直接通过菜单添加haitoken
启动 OpenCode TUI 界面 输入 /connect 命令 在供应商列表中选择 「Other」(自定义端点) 根据提示填写: Base URL:https://api.haitoken.ai/v1 API Key:你的 haitoken API Key 保存后,输入 /models 切换到新添加的模型即可
  1. 在项目根目录的 opencode.json 中配置 provider 和 Base URL:
"provider": {
    "haitoken": {
      "models": {
        "deepseek-v4-flash": {
          "name": "deepseek-v4-flash"
        },
        "deepseek-v4-pro": {
          "name": "deepseek-v4-pro"
        },
      },
      "name": "haitoken",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.haitoken.ai/v1"
      }
    }
  }
更多 AI 工具的接入方式,请参考 AI 工具接入 章节。

下一步