最近很多开发者在搭建 AI 应用、工作流或客户端时，都会遇到一个问题：

> 工具支持自定义 API，但是 Base URL、API Key、模型名称到底应该怎么填？

比如常见的这些工具：

- Dify
- FastGPT
- NextChat
- Cherry Studio
- Python / Node.js 项目

大多数情况下，只要工具支持 OpenAI-compatible API，就可以通过统一的接口格式接入。

## 一、需要准备什么？

通常只需要准备三项：

```text
Base URL
API Key
模型名称

以 Shiki API 为例：

Base URL：http://156.238.251.242:3000/v1
API Key：在后台创建
模型名称：以平台模型列表为准

一、Dify 接入方式

进入 Dify 后台：

Settings → Model Provider

选择 OpenAI 或 OpenAI-compatible Provider，然后填写：

Base URL：http://156.238.251.242:3000/v1
API Key：你的 API Key
Model：例如 gpt-4o-mini

保存后，可以发送一句测试：

你好，请用一句话介绍你自己。

如果能正常返回，说明配置成功。

二、NextChat 配置方式

打开 NextChat 设置页面，找到：

API Host / Base URL / Custom Endpoint

填写：

http://156.238.251.242:3000/v1

然后填写 API Key：

sk-xxxxxxxx

模型名称根据平台支持情况填写。

如果你是自部署 NextChat，可以参考环境变量：

OPENAI_API_KEY=sk-xxxxxxxx
BASE_URL=http://156.238.251.242:3000/v1
CUSTOM_MODELS=gpt-4o-mini,gpt-4o

三、Cherry Studio 配置方式

打开 Cherry Studio：

设置 → 模型服务 → 添加服务商

选择：

OpenAI Compatible

填写：

Base URL：http://156.238.251.242:3000/v1
API Key：你的 API Key
模型名称：例如 gpt-4o-mini

保存后新建对话测试即可。

四、Python 调用示例

安装依赖：

pip install openai

示例代码：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("OPENAI_API_KEY", "sk-your-api-key"),
    base_url=os.getenv("OPENAI_BASE_URL", "http://156.238.251.242:3000/v1"),
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": "你好，用一句话介绍你自己。"}
    ],
)

print(response.choices[0].message.content)

五、Node.js 调用示例

安装依赖：

npm install openai

示例代码：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY || "sk-your-api-key",
  baseURL: process.env.OPENAI_BASE_URL || "http://156.238.251.242:3000/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [
    { role: "user", content: "你好，用一句话介绍你自己。" },
  ],
});

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

六、常见错误

1. 401 Unauthorized

通常是 API Key 错误，检查：

API Key 是否复制完整
API Key 是否已启用
账号是否还有权限

2. 404 Model Not Found

通常是模型名称写错。

解决方法：

去平台模型列表复制完整模型名
不要自己随便猜模型名

3. 429 Rate Limited

说明请求太频繁或额度不足。

可以：

降低并发
更换模型
检查账号余额

4. 500 / 503

一般是服务端或上游模型异常。

可以：

稍后重试
切换模型
查看平台公告或状态

七、完整教程仓库

我把 Dify、FastGPT、NextChat、Cherry Studio、Python、Node.js 的接入示例整理到了 GitHub：TheShy0217/shiki-api-examples: OpenAI-compatible API integration examples for Shiki API

示例平台使用的是 Shiki API，兼容 OpenAI API 格式，适合 AI 应用、工作流、客户端和工具站快速接入。

如果只是想先测试配置，新用户可以领取少量测试额度，先跑通再决定是否继续使用。

地址：

New API

总结

OpenAI-compatible API 的核心配置其实很简单：

Base URL
API Key
Model Name

只要这三项正确，Dify、NextChat、Cherry Studio、FastGPT 以及代码项目基本都能快速接入。