Developer Docs

哈基咩中转站接入文档

从注册、API Key、Base URL 到第一次测试调用,把开发者最关心的接入路径写成可抓取、可复制、可验证的官方文档。

快速开始

第一步,访问控制台注册地址并创建账号。第二步,在控制台的 API 密钥页面创建自己的 API Key。第三步,把原项目或工具里的 Base URL 改为哈基咩公开入口。第四步,用短 prompt 做一次低成本测试,再回到控制台查看请求、Token、模型和余额变化。

接入时不要在截图、聊天窗口、公开表单或前端代码里提交真实 API Key。官网示例只使用 YOUR_API_KEY 占位符,真实密钥只应保存在本地环境变量、服务端环境变量或工具的安全配置区。

  1. 注册账号 打开 https://sub.xjyi.ccwu.cc/register,创建或登录哈基咩中转站控制台。
  2. 创建 API Key 在控制台复制自己的密钥,按项目或工具分开管理。
  3. 替换 Base URL 把 OpenAI-compatible 客户端的接口地址改为 https://api.xjyi.ccwu.cc/v1。
  4. 检查用量 测试后查看请求数量、Token、模型分布、余额和错误记录。

OpenAI SDK 示例

如果项目已经使用 OpenAI SDK,通常只需要替换 baseURL 与 apiKey。模型名、消息格式和返回结构应以控制台可用模型和实际返回为准。生产环境接入前,建议先用短文本、低并发和明确日志验证链路。

import OpenAI from "openai";

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

const completion = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "测试哈基咩中转站 API" }]
});

console.log(completion.choices[0].message.content);

接入前检查清单

确认 Base URL 不多写斜杠或路径,确认 API Key 没有空格,确认模型名在控制台可用,确认工具没有同时配置多个冲突代理。团队项目建议按用途拆分密钥,避免多人共用一个密钥导致排障困难。

如果调用失败,先看 HTTP 状态码、错误消息、模型名、余额和控制台请求日志。不要把密钥贴到公开聊天里排障;只提供错误码、工具名称、模型名和非敏感配置截图即可。

常见问题

哈基咩中转站是什么?

哈基咩中转站是面向开发者、AI 工具用户和团队项目的 AI API 统一接入服务,提供 OpenAI、Claude、Gemini 等模型的统一入口,并支持 OpenAI-compatible Base URL 与 API Key 调用。

API Base URL 是什么?

当前公开 API Base URL 是 https://api.xjyi.ccwu.cc/v1。用户在控制台创建 API Key 后,把 OpenAI SDK 或兼容工具里的 Base URL 改成这个地址即可开始测试。

1 元 = 1 美元额度是什么意思?

公开充值口径为 1 元人民币充值 1 美元额度,调用时按模型价格、实际消耗和渠道倍率扣费;实际扣费以控制台记录为准。

是否有试用额度或优惠码?

当前公开口径为暂时没有试用额度或优惠码。如后续增加活动,应以官网和控制台展示为准。

准备开始接入?

先创建 API Key,再按文档用短请求验证模型、余额和用量记录。

进入控制台