API 接入文档
兼容 OpenAI 接口格式,替换 Base URL 和 API Key 即可接入。支持 Chat Completions、Streaming、Function Calling、Vision。
注册账号
1
打开 和林 API 官网,点击右上角「免费注册」
2
输入手机号码,获取验证码,设置密码
3
注册成功后自动登录,新用户自动获得体验额度
获取 API Key
1
登录后台,点击左侧菜单「令牌管理」
2
点击「新建令牌」,设置令牌名称、额度上限、过期时间
3
点击提交,复制生成的
sk-xxxxxxxxxxxxxxxx该 Key 即为你的 API 密钥,所有客户端接入都需要使用。
充值额度
1
登录后台,点击左侧「充值」
2
选择充值档位:¥50 / ¥100 / ¥500 / ¥1000 / ¥5000
3
支付宝 / 微信扫码支付,即时到账。余额永不过期
Cherry Studio 配置
下载地址:https://www.cherry-ai.com/download
1
打开 Cherry Studio → 右上角「设置」→「模型提供方」
2
选择 OpenAI → 填入以下信息:
API 密钥:
API 地址:
API 密钥:
sk-你的APIKeyAPI 地址:
https://helinapi.com/v13
点击「检查」,显示连接成功即可使用
4
如没有想要的模型,点击「添加模型」手动输入模型 ID(如
deepseek-chat)LobeChat 配置
下载地址:https://lobehub.com/download
1
打开 LobeChat → 设置 → 语言模型
2
选择「OpenAI」→ 自定义接口地址填入:
https://helinapi.com/v13
API Key 填入后台生成的
sk-xxx4
点击检查连接,成功后即可选择模型开始对话
Cursor 配置
1
打开 Cursor → 设置(Ctrl+,)→ Models
2
取消勾选所有内置模型,勾选「OpenAI API Key」
3
填入:
Base URL:
API Key:
Base URL:
https://helinapi.com/v1API Key:
sk-你的APIKey4
在模型列表中添加你想用的模型 ID(如
deepseek-chat、deepseek-reasoner)Claude Code 配置
系统要求:Node.js >= 18.0,支持 macOS / Linux / Windows (WSL)
1
安装 Claude Code:
npm install -g @anthropic-ai/claude-code2
设置环境变量:
# Windows (PowerShell)
$env:ANTHROPIC_BASE_URL="https://helinapi.com/v1"
$env:ANTHROPIC_API_KEY="sk-你的APIKey"
# macOS / Linux
export ANTHROPIC_BASE_URL="https://helinapi.com/v1"
export ANTHROPIC_API_KEY="sk-你的APIKey"
3
终端输入
claude 启动如需持久化环境变量,将以上 export 命令添加到 ~/.bashrc 或 ~/.zshrc。
ChatBox 配置
1
打开 ChatBox → 设置 → 模型提供方 → OpenAI
2
API 密钥:
API 主机:
sk-你的APIKeyAPI 主机:
https://helinapi.com/v13
点击「检查」,连接成功后选择模型使用
Cline 配置
1
VS Code 安装 Cline 插件(扩展商店搜索 "Cline")
2
API Provider 选择「OpenAI Compatible」
3
填入:
Base URL:
API Key:
Model ID:
Base URL:
https://helinapi.com/v1API Key:
sk-你的APIKeyModel ID:
deepseek-chat 或 deepseek-reasonerOpenCat 配置
1
打开 OpenCat → 设置 → API
2
API Base URL:
API Key:
https://helinapi.com/v1API Key:
sk-你的APIKey3
点击测试连接,成功即可使用
CC Switch 配置
下载地址:Microsoft Store
1
安装并打开 CC Switch
2
添加配置:
Base URL:
API Key:
Base URL:
https://helinapi.com/v1API Key:
sk-你的APIKey3
选择模型,开始使用
对话接口
POST /v1/chat/completions
cURL
curl https://helinapi.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的APIKey" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好"}]
}'
Python
from openai import OpenAI
client = OpenAI(
base_url="https://helinapi.com/v1",
api_key="sk-你的APIKey"
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
Node.js
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://helinapi.com/v1',
apiKey: 'sk-你的APIKey'
});
const res = await client.chat.completions.create({
model: 'deepseek-chat',
messages: [{ role: 'user', content: '你好' }]
});
console.log(res.choices[0].message.content);
流式输出
设置 stream: true 启用 SSE 流式输出:
from openai import OpenAI
client = OpenAI(base_url="https://helinapi.com/v1", api_key="sk-xxx")
stream = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "写一首关于春天的诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
模型列表接口
GET /v1/models
curl https://helinapi.com/v1/models \
-H "Authorization: Bearer sk-你的APIKey"
错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
200 | 成功 | - |
401 | API Key 无效或已过期 | 检查 Key 是否正确,或重新生成 |
429 | 额度不足 / 请求限流 | 充值或降低调用频率 |
500 | 服务器内部错误 | 稍后重试,持续出现联系客服 |
503 | 上游模型不可用 | 模型厂商故障,稍后自动恢复 |
模型 & 价格
单位:¥ / 百万 Token
| 模型 ID | 模型名称 | 输入价格 | 输出价格 |
|---|---|---|---|
deepseek-chat | DeepSeek-V3 | ¥2.60 | ¥7.80 |
deepseek-reasoner | DeepSeek-R1 | ¥5.20 | ¥20.80 |
qwen3-235b | Qwen3-235B | ¥5.20 | ¥15.60 |
qwen3-32b | Qwen3-32B | ¥5.25 | ¥10.50 |
glm-4 | GLM-4 | ¥0.20 | ¥0.20 |
kimi-v1 | Kimi v1 | ¥18.00 | ¥18.00 |
spark-4 | 讯飞星火 4.0 | ¥0.20 | ¥0.20 |
minimax-1 | MiniMax-1 | ¥4.00 | ¥4.00 |
Base URL
https://helinapi.com/v1
所有 API 接口均以该地址为前缀。兼容 OpenAI SDK,替换 Base URL + API Key 即用。