接入文档
接口与通用 [OI] 协议兼容。任何支持自定义 Base URL 的客户端或 SDK 都能直接接入, 不需要插件、不需要改协议。
基础信息
- Base URL
- https://zhipool.top/v1
- 鉴权
- Authorization: Bearer <你的密钥>
- 请求路径
- /chat/completions · /embeddings · /models
- 可用模型
-
见价目表;也可请求
GET https://zhipool.top/v1/models获取当前列表。
curl
curl https://zhipool.top/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ZHIPOOL_API_KEY" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{ "role": "user", "content": "你好" }],
"stream": true
}' Python
from openai import [OI]
client = [OI](
api_key="YOUR_API_KEY",
base_url="https://zhipool.top/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="") Node.js
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.ZHIPOOL_API_KEY,
baseURL: 'https://zhipool.top/v1',
})
const stream = await client.chat.completions.create({
model: 'deepseek-v4.1-flash',
messages: [{ role: 'user', content: '你好' }],
stream: true,
})
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '')
} 常见客户端配置
各客户端的字段名不同,本质都是「把接口地址换成 https://zhipool.top/v1,把密钥填进去」。
| 客户端 | 需要填的字段 | 位置 |
|---|---|---|
| Cherry Studio | API 地址 | 设置 → 模型服务 → 添加提供商,填入 API 地址与密钥 |
| Lobe Chat | 接口代理地址 | 设置 → 语言模型 → 自定义服务商,填接口代理地址 |
| NextChat | 自定义接口 | 设置 → 自定义接口,填接口地址与密钥 |
| ChatBox | API 域名 | 设置 → 模型提供方 → 添加自定义提供方 |
| OpenCat | API Host | 设置 → 服务 → 自定义,填 API Host |
| 沉浸式翻译 | 自定义 API | 设置 → 翻译服务 → 自定义,填接口地址 |
使用注意
- · 密钥保密:密钥等于账户。 不要发到公开群、不要提交到代码仓库。泄露后立即到控制台删除并重建。
- · 并发限制:单账号有并发上限, 超限的请求会被拒绝并返回明确错误码,客户端应做退避重试。
-
· 推理模型:思考过程计入输出 token,
请按需调整
max_tokens,避免被截断。 - · 用量核对:每次调用的输入、输出、 缓存命中与实际扣费都会落库,可在控制台逐条对账。
- · 计费单位:元 / 每百万 token, 输入、输出、缓存三档分别计价,见价目表。