接入文档
本站接口兼容 OpenAI 与 Anthropic 两种格式。已经在用 OpenAI / Anthropic SDK、Claude Code,或任何支持自定义接口地址的客户端, 只需要替换接口地址和 API Key 两项,其余代码不用改。
三个关键信息
不管在哪里配置,要填的永远是下面这三样。
接口地址要不要带 /v1?这是最常见的配置错误。
规则是看填写框的说明文字:写着「Base URL」「API 地址」「接口地址」的,一般带上 /v1;
少数客户端会自己补 /v1,那就只填到 https://api.insi-ai.com。
判断方法很简单:先填带 /v1 的版本,如果报 404,就去掉 /v1 再试一次。两种里必有一种能通。
获取 API Key
- 登录 控制台
- 进入「令牌」页面,点击新建
- 填写名称(随便起,方便自己区分即可)
- 选择分组(必选):按你要用的模型选,见下表
- 设置额度:可以打开「无限配额」,也可以关掉后设一个上限,防止超支
- 保存后复制生成的
sk-开头字符串
| 分组 | 能调用的模型 | 适合 |
|---|---|---|
| 文本模型 | DeepSeek、通义千问、Kimi、智谱 GLM 等对话模型 | 聊天、写代码、Claude Code、各类客户端,大多数人选这个 |
| 视频模型 | 视频生成类模型 | 文生视频、图生视频 |
分组一定要选,而且要选对。令牌只能调用它所在分组里的模型: 用「视频模型」分组的 Key 去调对话模型,会报模型不可用或无权限。
文本和视频都要用?建两个令牌,各选一个分组。
API Key 等同于账户余额的使用凭证,请勿写在前端代码、公开仓库或截图里。 怀疑泄露时,回控制台删除该令牌并新建一个即可,不影响其他令牌。
模型名称
请求里的 model 字段必须逐字符照抄下表,大小写和连字符都不能改。
| 模型名称(model) | 说明 |
|---|---|
deepseek-v4-flash-0731 | DeepSeek 轻量版,成本最低 |
deepseek-v4-pro-0813 | DeepSeek 旗舰版,复杂推理与 Agent 场景 |
kimi-k3 | Kimi K3 |
qwen3.8-flash | 通义千问轻量版 |
qwen3.8-max | 通义千问旗舰版 |
ZHIPU/GLM-5.3 | 智谱 GLM,注意这个名称带 ZHIPU/ 前缀 |
各模型的实时价格与上下文长度以 模型广场 为准。
代码接入
本站同时提供两种接口格式,模型名称、API Key 通用,选你现有代码在用的那种即可。
| 格式 | 接口路径 | 适合 |
|---|---|---|
| OpenAI 兼容(推荐) | POST /v1/chat/completions | 绝大多数 SDK、客户端、Agent 框架 |
| Anthropic 兼容 | POST /v1/messages | Claude Code、Anthropic SDK 写的代码 |
OpenAI 格式
任何 OpenAI 官方 SDK 都能直接用,只改初始化时的两个参数。
from openai import OpenAI
client = OpenAI(
api_key="sk-你的Key",
base_url="https://api.insi-ai.com/v1", # 只改这一行
)
resp = client.chat.completions.create(
model="qwen3.8-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的Key",
baseURL: "https://api.insi-ai.com/v1", // 只改这一行
});
const resp = await client.chat.completions.create({
model: "qwen3.8-flash",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
curl https://api.insi-ai.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.8-flash",
"messages": [{"role": "user", "content": "你好"}]
}'
流式输出
加上 stream=True(Node 为 stream: true)即可,行为与 OpenAI 一致。
Anthropic 格式
用 Anthropic 官方 SDK 时同样只改两个参数,model 填本站的模型名称。
Anthropic SDK 的地址不带 /v1,填到 https://api.insi-ai.com 为止,SDK 会自己拼上 /v1/messages。
import anthropic
client = anthropic.Anthropic(
api_key="sk-你的Key",
base_url="https://api.insi-ai.com", # 不带 /v1
)
msg = client.messages.create(
model="qwen3.8-flash",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "sk-你的Key",
baseURL: "https://api.insi-ai.com", // 不带 /v1
});
const msg = await client.messages.create({
model: "qwen3.8-flash",
max_tokens: 1024,
messages: [{ role: "user", content: "你好" }],
});
console.log(msg.content[0].text);
curl https://api.insi-ai.com/v1/messages \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.8-flash",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'
Claude Code
Claude Code 走的是 Anthropic 格式,把它指向本站后,就能用国产模型在终端里写代码。 推荐写进配置文件,一次配好,以后打开就能用。
第一步:安装
npm install -g @anthropic-ai/claude-code
需要先装好 Node.js 18 或更高版本。
第二步:写配置
打开(没有就新建)用户目录下的 .claude/settings.json,
Windows 是 C:\Users\你的用户名\.claude\settings.json,
macOS / Linux 是 ~/.claude/settings.json,写入:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.insi-ai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "deepseek-v4-pro-0813",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash-0731"
}
}
| 配置项 | 作用 |
|---|---|
ANTHROPIC_BASE_URL | 本站地址,不带 /v1 |
ANTHROPIC_AUTH_TOKEN | 在控制台创建的 Key |
ANTHROPIC_MODEL | 主模型,写代码、做规划用,建议选旗舰版 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 后台小任务用的模型,选轻量版更省钱 |
第三步:启动
进入你的项目目录,运行 claude。配置正确时会直接进入对话界面,不需要登录 Anthropic 账号。
只想临时试一下?不写配置文件,直接在当前终端设环境变量也行(关掉终端就失效):
$env:ANTHROPIC_BASE_URL = "https://api.insi-ai.com" $env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key" $env:ANTHROPIC_MODEL = "deepseek-v4-pro-0813" claude
export ANTHROPIC_BASE_URL="https://api.insi-ai.com" export ANTHROPIC_AUTH_TOKEN="sk-你的Key" export ANTHROPIC_MODEL="deepseek-v4-pro-0813" claude
启动后还是让你登录?说明配置没生效。检查 settings.json 是不是合法 JSON(逗号、引号),
以及文件是不是放在了用户目录下的 .claude 文件夹里,而不是项目目录。
客户端配置
下面这些工具都支持自定义 OpenAI 接口。不同版本的菜单名称可能略有出入, 但要填的永远是那三样:接口地址、API Key、模型名称。 找不到对应菜单时,认准「OpenAI」「自定义」「兼容接口」这类字样即可。
Cherry Studio
- 路径
- 设置 → 模型服务 → 添加提供商(类型选 OpenAI)
- API 地址
- https://api.insi-ai.com
- API 密钥
- sk-你的Key
- 模型
- 手动添加,填上表中的模型名称
ChatBox
- 路径
- 设置 → 模型 → 模型提供方选「OpenAI API 兼容」
- API 域名
- https://api.insi-ai.com/v1
- API 密钥
- sk-你的Key
- 模型
- 自定义填写模型名称
LobeChat / NextChat
- 路径
- 设置 → 语言模型 → OpenAI
- 接口代理地址
- https://api.insi-ai.com/v1
- API Key
- sk-你的Key
- 模型
- 在自定义模型名中填入
Open WebUI
- 路径
- 设置 → 外部连接 → OpenAI API
- API 基础地址
- https://api.insi-ai.com/v1
- API 密钥
- sk-你的Key
Dify
- 路径
- 设置 → 模型供应商 → OpenAI-API-compatible
- API endpoint URL
- https://api.insi-ai.com/v1
- API Key
- sk-你的Key
- 模型名称
- 逐字填写,需同时设置上下文长度
沉浸式翻译
- 路径
- 设置 → 翻译服务 → OpenAI → 展开更多配置
- 自定义 API 地址
- https://api.insi-ai.com/v1/chat/completions
- API Key
- sk-你的Key
- 模型
- 建议选轻量模型控制成本
这里要填完整的接口路径,末尾带 /chat/completions,和其他客户端不同。
WorkBuddy
- 路径
- 底部模型选择器 → 配置自定义模型 → 添加模型 → 提供商选「自定义 / Custom」
- 接口地址
- https://api.insi-ai.com/v1/chat/completions
- API Key
- sk-你的Key(文本模型分组)
- 模型名称
- 逐字填写上表中的模型名称
- 工具调用
- 建议打开,WorkBuddy 执行任务要靠它
WorkBuddy 只支持 OpenAI 格式,接口地址要填完整路径,末尾带 /chat/completions。
如果保存后报 404,改填 https://api.insi-ai.com/v1 再试。
也可以直接改配置文件 ~/.workbuddy/models.json(Windows 是 C:\Users\你的用户名\.workbuddy\models.json),保存后约 1 秒自动生效:
{
"models": [
{
"id": "deepseek-v4-pro-0813",
"name": "DeepSeek V4 Pro(英思智创)",
"vendor": "Custom",
"url": "https://api.insi-ai.com/v1/chat/completions",
"apiKey": "sk-你的Key",
"supportsToolCall": true,
"supportsImages": false
}
]
}
想加多个模型,就在 models 数组里再复制一段,改掉 id 和 name。改文件前先备份原文件。
DeepSeek Harness(dsh)
- 路径
- 设置 → 模型 → 添加模型提供商(或「添加自定义提供方」)→ 自定义模型 API
- Provider ID
- insi
- 显示名称
- 英思智创
- API 协议
- OpenAI Chat Completions
- API 地址
- https://api.insi-ai.com/v1
- API 密钥
- sk-你的Key(文本模型分组)
- 模型
- 点「获取可用模型」勾选,或手动添加上表中的模型名称
协议选 Anthropic Messages 也可以,但这时 API 地址不带 /v1,填 https://api.insi-ai.com。
保存后在对话框右下角的模型选择器里切到刚添加的模型。不同版本的菜单名称略有出入,认准「自定义」「提供方」即可。
也可以写进配置文件 $DSH_HOME/settings.yaml(默认在用户目录下的 .dsh 文件夹,Windows 为 C:\Users\你的用户名\.dsh\settings.yaml):
llm-pi-ai:
providers:
insi:
displayName: 英思智创
apiKeyEnv: INSI_API_KEY
api: openai-completions
baseURL: https://api.insi-ai.com/v1
models:
- id: deepseek-v4-pro-0813
- id: qwen3.8-max
配置文件里不写 Key 本身,而是通过 apiKeyEnv 指向一个环境变量,再把 Key 设到这个变量里:
[Environment]::SetEnvironmentVariable("INSI_API_KEY", "sk-你的Key", "User")
echo 'export INSI_API_KEY="sk-你的Key"' >> ~/.zshrc && source ~/.zshrc
设完环境变量要重启 dsh(Windows 还要重开终端),否则会报 401 或 MISSING_CREDENTIAL。
Cursor / Cline / Continue
- 提供方
- 选择 OpenAI Compatible
- Base URL
- https://api.insi-ai.com/v1
- API Key
- sk-你的Key
- 模型
- 建议用旗舰版模型,代码任务对能力要求较高
错误码速查
请求失败时先看 HTTP 状态码,再对照下表。失败的请求不扣费。
| 状态码 | 意思 | 怎么办 |
|---|---|---|
400 | 请求参数有误 | 检查 JSON 格式、messages 结构;Anthropic 格式别漏了 max_tokens |
401 | Key 无效 | Key 复制不完整、有空格,或已被删除。回控制台核对 |
403 | 没有权限 | 令牌分组选错(比如用视频分组的 Key 调对话模型)、余额或令牌额度用完,或该令牌限制了可用模型 / IP,到控制台查看令牌设置 |
404 | 地址不对 | 九成是 /v1 多了或少了,见上文「三个关键信息」 |
429 | 请求太频繁 | 降低并发,或失败后等几秒再重试(建议指数退避) |
500 / 502 / 503 | 上游模型暂时不可用 | 稍后重试,或换一个模型;持续出现请联系我们 |
| 超时 | 回复太长、等待太久 | 开启流式输出,或把客户端的超时时间调到 120 秒以上 |
常见问题
报 404 Not Found
九成是接口地址的 /v1 写错了。带着 /v1 报 404 就去掉,不带的报 404 就加上,两种必有一种能通。
另一种可能是地址末尾多了斜杠或空格,检查一下有没有复制进多余字符。
报 401 Unauthorized
Key 不对。常见原因:复制时漏了字符或带了空格、Key 已在控制台被删除、误填成了别家平台的 Key。
回控制台确认令牌还在且状态正常,必要时新建一个。
提示模型不存在
model 字段写错了。必须和模型名称表里的字符串完全一致,包括大小写和连字符。
最容易出错的是 ZHIPU/GLM-5.3——它带前缀且是大写,和其他模型的写法不一样。
名称确认没错还是报这个,就检查令牌的分组:对话模型要用「文本模型」分组的 Key。
提示余额不足
账户余额或该令牌的额度用完了。到控制台充值,或调高该令牌的额度上限。
返回结果不是逐字出现的
说明请求没有开启流式。在请求里加 stream: true;如果是客户端,检查设置里有没有「流式输出」开关。
能用官方 SDK 吗?需要改代码吗?
能,且只需要改 base_url 和 api_key 两个参数,其他调用代码原样不动。
我的请求内容会被保存吗?
不会。平台只记录用量数据(token 数、模型名称、时间、状态),不保存请求内容与返回内容。
还是不通,怎么找人
在首页点「联系我们」,扫码或直接联系商务,把报错信息和你填写的接口地址一起发过来,能更快定位。