Documentation

五分钟完成第一次调用

星桥 API 当前提供 DeepSeek 的 OpenAI 兼容接口。内测阶段账号由管理员创建；获得账号后，按照本页完成 API Key 和客户端配置。

当前已开放 deepseek-chat 与 deepseek-reasoner，请求时请使用完全一致的模型 ID。

1. 开始之前

你需要一个已开通的账号、可用余额和一个 API Key。OpenAI Compatible Base URL 为：

https://api.example.com/v1

模型请求使用本站生成的 API Key 鉴权。不要把管理员密码或上游厂商密钥填到客户端。

2. 创建和管理 API Key

  1. 登录控制台，进入“API 密钥”页面（/keys）。
  2. 选择“创建 API Key”，填写能辨认项目用途的名称。
  3. 按需设置并发、过期时间和允许访问的分组。
  4. 创建后立即复制 Key 并安全保存。页面可能不会再次完整显示。

不同应用应使用不同 Key。项目停用或怀疑泄露时，应立即禁用或删除对应 Key，而不是继续复用。

3. curl 示例

curl https://api.example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "stream": false
  }'

4. Python SDK

安装官方 OpenAI SDK：

pip install --upgrade openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://api.example.com/v1",
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

5. Node.js SDK

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-key",
  baseURL: "https://api.example.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "你好" }],
});

console.log(response.choices[0].message.content);

6. 通用客户端配置

任何支持“自定义 OpenAI API 地址”的客户端，一般只需填写以下三项：

配置项填写内容说明
API 类型OpenAI / OpenAI Compatible使用 API Key 鉴权模式
API 地址https://api.example.com/v1部分客户端会自动追加 /v1，注意避免重复
API Keysk-your-key使用本站控制台生成的用户 Key

Cherry Studio

进入“设置 → 模型服务”，添加 OpenAI 兼容服务商，填写 API 地址和 Key，然后添加 deepseek-chat 或 deepseek-reasoner。

ChatBox

在模型提供方中选择 OpenAI API 或自定义提供方，将 API Host 修改为本站 Base URL，并填写用户 Key。

NextChat

部署或设置时将接口地址指向本站域名。不同版本的字段名可能是 API Host、Base URL 或 Endpoint。

客户端界面会随版本变化。如果测试连接失败，先使用本页 curl 示例区分是客户端配置问题还是接口问题。

7. 模型名称和计费

请求中的 model 必须使用 deepseek-chat 或 deepseek-reasoner。内测阶段的最终费用以控制台消费日志为准。

8. 常见错误

状态码/提示常见原因处理方法
401API Key 缺失、错误、过期或已禁用检查鉴权格式并重新生成 Key
403API Key 没有分组权限或账号被限制检查 Key 的访问范围，联系管理员
429触发请求频率、并发或上游限额降低并发并使用指数退避重试
余额不足账号余额或订阅额度耗尽检查余额，内测阶段联系管理员人工充值
模型不存在模型 ID 拼写错误或尚未开放检查是否填写了已开放的 DeepSeek 模型 ID
5xx / 上游错误渠道暂时不可用或响应超时保留请求时间和 Request ID 后反馈

9. 安全与使用规范