Base URL Guide

API Base URL 怎么填写

本页专门回答用户最常见的接入问题:Base URL 应该填哪里、为什么要带 /v1、OpenAI SDK 如何改、工具报错时先查什么。

公开 Base URL

哈基咩 API 中转站当前公开 API Base URL 为 https://api.xjyi.ccwu.cc/v1。如果你的项目或工具支持 OpenAI-compatible endpoint,通常把原来的 OpenAI 接口地址替换为这个地址,再填写自己的 API Key 即可开始测试。

不要把 Base URL 写成官网地址,也不要把控制台注册地址当成 API 地址。官网用于说明和注册,控制台用于创建 API Key,真正发起模型请求时使用的是 API Base URL。

  1. 官网主页 用于了解服务、查看文档和进入控制台。
  2. 控制台注册地址 用于创建账号和管理 API Key:https://sub.xjyi.ccwu.cc/register
  3. API Base URL 用于 SDK 或工具请求模型:https://api.xjyi.ccwu.cc/v1
  4. 模型路径 多数 OpenAI SDK 会自动拼接 /chat/completions 等路径,不需要手动重复填写。

OpenAI SDK 配置示例

Node.js 项目里只需要把 apiKey 和 baseURL 改成哈基咩中转站的配置。真实 API Key 应放在环境变量里,不要提交到 GitHub、前端代码、公开截图或聊天窗口。

import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "测试 Base URL 是否可用" }]
});

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

curl 连通性测试

如果你不确定是工具配置问题还是接口链路问题,可以先用 curl 发一个短请求。短请求成本更低,也更容易判断 API Key、Base URL、模型名和余额是否正常。

curl https://api.xjyi.ccwu.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"ping"}]
  }'

常见填写错误

常见错误包括漏写 /v1、把官网域名当作 API 地址、把注册地址当作 API 地址、在工具里重复拼接 /v1/v1、API Key 前后有空格、模型名不在控制台可用列表中。出现失败时先看控制台是否有请求记录,再判断请求是否真正到达平台。

如果控制台完全没有请求记录,通常是 Base URL、网络代理、工具自动拼接路径或请求格式还没打到平台。如果控制台有失败记录,再继续检查模型名、余额、上下文长度和渠道状态。

常见问题

Base URL 一定要带 /v1 吗?

是。当前公开 Base URL 为 https://api.xjyi.ccwu.cc/v1,建议按完整地址填写,避免工具无法正确拼接 OpenAI-compatible 路径。

可以把 Base URL 写成 https://index.hjmie.cc.cd 吗?

不可以。https://index.hjmie.cc.cd 是官网地址,用于阅读文档和进入控制台;模型请求应使用公开 API Base URL。

为什么填写后还是没有请求记录?

通常说明请求没有到达平台,请检查工具是否支持自定义 endpoint、是否自动拼接路径、网络代理是否拦截,以及 API Key 是否填在正确位置。

准备开始接入?

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

进入控制台