SJAPI 使用文档
统一接入多模型 API
本文档用于帮助用户在 SJAPI 创建令牌、配置 Base URL，并通过 OpenAI 兼容接口接入常见 SDK 和客户端。模型、价格、额度和可用渠道以主站后台显示为准。
API Base URL
https://www.sjapi.top/v1
在 OpenAI SDK 或客户端里填写 Base URL 时使用这个地址。不要把它当成普通网页打开。
Authorization
Bearer 你的令牌
快速开始
按照下面四步即可完成第一次调用。
1
注册并登录
打开主站，完成账号注册和登录。
2
充值或获取额度
确保账户余额足够，避免调用时报余额不足。
3
创建令牌
在令牌页面创建 API Key，并立即保存。
4
配置 Base URL
把客户端或 SDK 的地址改为本文档提供的接口地址。
建议：第一次测试时先用简单模型和短 prompt，确认配置无误后再进行长文本或高成本调用。
创建令牌
- 登录 SJAPI 主站。
- 进入令牌、Token 或 API Key 管理页面。
- 点击新建令牌，填写名称，例如
Cherry Studio或Python Test。 - 创建后立即复制完整令牌。部分系统只会完整展示一次。
- 如果令牌泄露，立即删除旧令牌并创建新令牌。
不要泄露令牌：API Key 等同于账户额度凭证，不要发到群聊、截图、公开仓库、前端网页或浏览器控制台。
curl 示例
把下面的 YOUR_API_KEY 替换为你在主站创建的令牌。模型名请使用主站后台可用模型。
curl https://www.sjapi.top/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "你好，请用一句话介绍 SJAPI。" }
],
"stream": false
}'如果返回模型不存在，请到主站查看实际支持的模型名，并替换 model 字段。
OpenAI SDK 示例
Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://www.sjapi.top/v1",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "写一个三句话的产品介绍。"}
],
)
print(response.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://www.sjapi.top/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [
{ role: "user", content: "写一个三句话的产品介绍。" }
],
});
console.log(response.choices[0].message.content);
说明：New API 通常提供 OpenAI-compatible 的 Chat Completions 接口。不同客户端对 Responses API、图片、语音或工具调用的支持程度不同，请以实际模型和主站配置为准。
模型填写
模型名必须填写主站后台支持的模型标识。不同站点、分组或渠道可用模型可能不同。
| 项目 | 填写建议 | 常见问题 |
|---|---|---|
| Base URL | https://www.sjapi.top/v1 |
不要漏掉 /v1。 |
| API Key | 填写主站创建的令牌 | 不要填写主站登录密码。 |
| Model | 填写主站模型列表中的模型名 | 模型名错误会返回模型不存在或无权限。 |
| Stream | 客户端支持时可开启 | 部分上游或模型不支持流式输出。 |
客户端配置总览
大多数支持 OpenAI 自定义接口的客户端，都可以按下面三项配置。
| 配置项 | 填写内容 |
|---|---|
| Provider / 服务商 | 选择 OpenAI、OpenAI Compatible、自定义 OpenAI，或类似选项。 |
| API Key | 填写 SJAPI 主站创建的令牌。 |
| API Host / Base URL | https://www.sjapi.top/v1 |
| Model | 填写主站支持的模型名。 |
Cherry Studio 配置
- 打开 Cherry Studio 设置。
- 进入模型服务或服务商配置。
- 新增 OpenAI 兼容服务商。
- API Key 填写你在 SJAPI 创建的令牌。
- API 地址填写
https://www.sjapi.top/v1。 - 添加模型名，保存后发起测试对话。
如果客户端要求填写完整接口地址，请优先尝试
https://www.sjapi.top/v1。如果它自动拼接 /chat/completions，不要手动重复填写完整路径。
Chatbox 配置
- 打开 Chatbox 设置。
- 模型提供方选择 OpenAI API 或自定义 OpenAI API。
- API Key 填写 SJAPI 令牌。
- API Host 填写
https://www.sjapi.top/v1。 - 模型填写主站可用模型名。
- 保存后新建对话测试。
常见错误
| 错误 | 可能原因 | 处理方式 |
|---|---|---|
401 / Unauthorized |
令牌错误、令牌被删除、Authorization 格式不对。 | 检查是否使用 Bearer YOUR_API_KEY，重新复制令牌。 |
| 余额不足 | 账户额度不足或分组额度不足。 | 充值后重试，或检查当前账号/分组。 |
| 模型不存在 | 模型名拼写错误，或当前分组无权使用。 | 到主站模型列表查看准确模型名。 |
429 |
请求过快、并发过高、触发限速。 | 降低并发，稍后重试，或查看站点限速说明。 |
502 / 503 |
上游服务异常、网络波动、渠道暂不可用。 | 稍后重试，或切换模型/渠道。 |
| 上下文超限 | 输入内容太长，超过模型上下文窗口。 | 缩短输入，分批处理，或换更大上下文模型。 |
安全说明
- 不要在前端网页、浏览器代码、公开仓库或截图里暴露 API Key。
- 不要和他人共用同一个令牌。建议不同客户端创建不同令牌。
- 发现异常消耗时，先删除相关令牌，再检查调用记录。
- 不要用于违法、侵权、垃圾信息、攻击测试或其他违反服务条款的用途。
- 重要业务建议自行记录请求 ID、时间、模型和消耗，方便排查。
API 中转服务会连接第三方上游模型。请不要提交高度敏感的个人隐私、密码、密钥、未公开商业机密或受法律限制的数据。
FAQ
为什么浏览器打开 /v1 看起来是错误页面？
/v1 是给 SDK 和客户端调用的 API 地址，不是普通网页。只要 SDK 能正常请求即可。
为什么同一个模型有时可用、有时失败？
可能是上游波动、渠道限速、模型维护或账户额度问题。可以稍后重试，或换模型测试。
请求失败会不会扣费？
一般以主站后台的计费和日志为准。不同失败类型处理方式可能不同，请查看调用记录确认。
能不能把 Key 写到前端项目里？
不建议。前端代码会暴露给用户，Key 可能被盗用。请通过后端服务转发请求。