应用配置

Hakan AI 完全兼容 OpenAI / Anthropic / Gemini 协议，可以在几乎所有支持自定义 Base URL 的客户端 / 应用中使用。下面列出常见客户端的配置参数。

🔑 Base URL 应该填什么？

最常见的问题。一句话规则：

用 SDK 就只填 base 前缀，SDK 会自动拼出完整路径；用 curl / 原生 HTTP 必须自己写全。

用 SDK —— 填到下表的"应填值"即可

⚠️ OpenAI SDK 一定要带 /v1：不带的话 SDK 会拼成 …/chat/completions → 404 ⚠️ Anthropic / Gemini SDK 一定不要带 /v1：带了的话 SDK 会拼成 …/v1/v1/messages → 404

用 curl / Postman / 自己写 HTTP —— 必须写完整路径

# ❌ 这样不行 —— /v1 不是一个端点
curl https://hakanaiktn.com/v1 -d '{...}'

# ✅ 必须给完整路径
curl https://hakanaiktn.com/v1/chat/completions  -d '{"model":"gpt-5",...}'
curl https://hakanaiktn.com/v1/messages          -d '{"model":"claude-...",...}'
curl https://hakanaiktn.com/v1/embeddings        -d '{"model":"text-embedding-3-small",...}'
curl https://hakanaiktn.com/v1/images/generations -d '{"model":"gpt-image-2",...}'

/v1/chat/completions、/v1/messages、/v1/responses 等是 不同的 HTTP 路由，对应不同协议（OpenAI Chat / Anthropic / Responses）。服务器靠路径判断该用哪条协议解析，少了路径就不行。

第三方客户端（Cherry Studio / NextChat / Open WebUI 等）

这些客户端的"API 地址"输入框风格不一，三种填法依次试一次就能确定：

1. https://hakanaiktn.com
2. https://hakanaiktn.com/v1
3. https://hakanaiktn.com/v1/chat/completions

报 404 / Cannot POST 一般就是路径没拼对，换下一种试。

全部端点速查（高级用户）

想知道某个具体模型推荐填哪个 base_url？打开 模型广场，点对应模型的「详情」→「API」标签页，里面会给出该模型推荐的 base_url。

通用配置要点

• Base URL：https://hakanaiktn.com/v1（对于 Anthropic / Gemini 原生协议，去掉 /v1）
• API Key：在 令牌管理 中复制
• 模型名：在 模型列表 中复制

OpenAI 兼容客户端

Cherry Studio

1. 设置 → 模型服务 → 添加自定义服务商
2. 服务商类型：OpenAI
3. API Host：https://hakanaiktn.com
4. API Key：粘贴你的令牌
5. 添加要使用的模型名称，保存

LobeChat / NextChat / ChatBox

1. 设置 → 模型服务（或语言模型）→ OpenAI
2. API Key：粘贴你的令牌
3. 接口代理地址 / API Endpoint：https://hakanaiktn.com/v1
4. 自定义模型：填入你要用的模型名（如 gpt-4o、claude-sonnet-4-5-20250929）

Open WebUI

1. 设置 → 外部连接 → OpenAI API
2. API Base URL：https://hakanaiktn.com/v1
3. API Key：粘贴你的令牌

编程开发工具

Cursor

1. Settings → Models → OpenAI API Key 区域
2. 勾选 Override OpenAI Base URL
3. URL：https://hakanaiktn.com/v1
4. API Key：粘贴你的令牌
5. 点击 Verify 验证

Cursor 仅会将 OpenAI 模型走到自定义 URL，Claude / Gemini 仍会走 Cursor 官方付费通道，需要使用 OpenAI 路径调用其他模型时可使用 OpenAI 协议中转的 Claude / Gemini 模型名。

Continue / Cline / Roo Code

在配置文件中指定 OpenAI Compatible 提供商：

{
  "provider": "openai",
  "apiBase": "https://hakanaiktn.com/v1",
  "apiKey": "sk-xxxxxxxx",
  "model": "gpt-4o"
}

原生 SDK

详细的官方 SDK 示例代码请参见：

• OpenAI 接口
• Anthropic 接口
• Gemini 接口

其他工具

LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-4o",
    base_url="https://hakanaiktn.com/v1",
    api_key="sk-xxxxxxxx",
)

Telegram / Discord Bot

任何支持 OpenAI 协议的 bot 框架（如 python-telegram-bot + openai）都可正常使用，只需把 base_url 改为 https://hakanaiktn.com/v1 即可。

找不到你的应用？

只要应用支持自定义 OpenAI 兼容接口（即可填 Base URL 与 API Key），都可以接入 Hakan AI。如果遇到问题，请前往 常见问题 或 联系客服。