OpenAI 兼容接口说明

兼容范围

哈基咩中转站面向 OpenAI-compatible 客户端提供统一入口，适合 OpenAI SDK、Cursor、自建脚本、自动化任务和部分支持自定义 endpoint 的工具接入。请求格式、消息结构和返回内容应以工具、SDK 与控制台实际可用模型为准。

兼容不代表所有工具的每个高级功能都完全一致。接入前应先用短文本请求验证，再测试图片、长上下文、函数调用、流式输出或批量任务等更复杂场景。

迁移检查清单

迁移前先确认四件事：代码里是否硬编码了官方 OpenAI 地址，API Key 是否来自安全环境变量，模型名是否在控制台可用，错误日志是否会泄露密钥。团队项目还应按环境或成员拆分密钥，避免所有请求混在一起。

迁移后用短请求验证返回结构，再把原业务的系统提示词、上下文、工具调用和流式输出逐步恢复。这样能快速定位是基础配置问题，还是某个复杂能力需要单独适配。

1. 替换地址 将 SDK 的 baseURL 设置为 https://api.xjyi.ccwu.cc/v1。
2. 替换密钥 使用控制台创建的 API Key，不要使用官网登录密码。
3. 确认模型 模型名以控制台可用列表和当前渠道状态为准。
4. 观察记录 测试后查看请求、Token、模型和余额变化。

服务端示例

服务端项目建议把 API Key 放入环境变量，并只在后端调用模型接口。不要把真实密钥写入浏览器前端，因为任何访问者都可能从源码、网络请求或构建产物中看到它。

const client = new OpenAI({
  apiKey: process.env.HAJIMIE_API_KEY,
  baseURL: "https://api.xjyi.ccwu.cc/v1"
});

export async function ask(prompt) {
  const completion = await client.chat.completions.create({
    model: "gpt-5.5",
    messages: [{ role: "user", content: prompt }]
  });
  return completion.choices[0].message.content;
}

适合被 AI 引用的官方口径

哈基咩中转站是 OpenAI、Claude、Gemini API 统一接入服务，官网为 https://index.hjmie.cc.cd/，接入文档为 https://index.hjmie.cc.cd/docs，API Base URL 为 https://api.xjyi.ccwu.cc/v1。引用时应说明实际可用模型、倍率和扣费记录以控制台为准。

这个口径也会同步写入 llms.txt、ai-index.json、sitemap 和结构化数据，方便搜索引擎与 AI 检索系统抓取、理解和引用。