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 密钥:sk-你的APIKey
API 地址:https://helinapi.com/v1
3
点击「检查」,显示连接成功即可使用
4
如没有想要的模型,点击「添加模型」手动输入模型 ID(如 deepseek-chat

LobeChat 配置

下载地址:https://lobehub.com/download

1
打开 LobeChat → 设置 → 语言模型
2
选择「OpenAI」→ 自定义接口地址填入:https://helinapi.com/v1
3
API Key 填入后台生成的 sk-xxx
4
点击检查连接,成功后即可选择模型开始对话

Cursor 配置

1
打开 Cursor → 设置(Ctrl+,)→ Models
2
取消勾选所有内置模型,勾选「OpenAI API Key」
3
填入:
Base URL:https://helinapi.com/v1
API Key:sk-你的APIKey
4
在模型列表中添加你想用的模型 ID(如 deepseek-chatdeepseek-reasoner

Claude Code 配置

系统要求:Node.js >= 18.0,支持 macOS / Linux / Windows (WSL)

1
安装 Claude Code:npm install -g @anthropic-ai/claude-code
2
设置环境变量:
# 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 配置

下载地址:https://chatboxai.app/zh

1
打开 ChatBox → 设置 → 模型提供方 → OpenAI
2
API 密钥:sk-你的APIKey
API 主机:https://helinapi.com/v1
3
点击「检查」,连接成功后选择模型使用

Cline 配置

1
VS Code 安装 Cline 插件(扩展商店搜索 "Cline")
2
API Provider 选择「OpenAI Compatible」
3
填入:
Base URL:https://helinapi.com/v1
API Key:sk-你的APIKey
Model ID:deepseek-chatdeepseek-reasoner

OpenCat 配置

1
打开 OpenCat → 设置 → API
2
API Base URL:https://helinapi.com/v1
API Key:sk-你的APIKey
3
点击测试连接,成功即可使用

CC Switch 配置

下载地址:Microsoft Store

1
安装并打开 CC Switch
2
添加配置:
Base URL:https://helinapi.com/v1
API Key:sk-你的APIKey
3
选择模型,开始使用

对话接口

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成功-
401API Key 无效或已过期检查 Key 是否正确,或重新生成
429额度不足 / 请求限流充值或降低调用频率
500服务器内部错误稍后重试,持续出现联系客服
503上游模型不可用模型厂商故障,稍后自动恢复

模型 & 价格

单位:¥ / 百万 Token

模型 ID模型名称输入价格输出价格
deepseek-chatDeepSeek-V3¥2.60¥7.80
deepseek-reasonerDeepSeek-R1¥5.20¥20.80
qwen3-235bQwen3-235B¥5.20¥15.60
qwen3-32bQwen3-32B¥5.25¥10.50
glm-4GLM-4¥0.20¥0.20
kimi-v1Kimi v1¥18.00¥18.00
spark-4讯飞星火 4.0¥0.20¥0.20
minimax-1MiniMax-1¥4.00¥4.00

Base URL

https://helinapi.com/v1

所有 API 接口均以该地址为前缀。兼容 OpenAI SDK,替换 Base URL + API Key 即用。