心数据接入教程：三步调用大模型 API

心数据兼容 OpenAI 接口格式，任何支持配置 base_url 的 OpenAI SDK、框架（LangChain、LobeChat、Dify、NextChat 等）都能直接使用。整个过程不超过 5 分钟。

第 1 步 · 注册并创建 API Key
注册心数据账号后进入控制台，在「令牌」页面点击新建令牌，可按需设置额度上限、有效期与可用模型。复制生成的 sk-... 密钥。

第 2 步 · 替换 base_url
把代码中的 OpenAI 地址改为心数据网关地址：
https://api.xinshuju.net/v1

第 3 步 · 指定模型发起调用
在请求的 model 参数里填要用的模型名，即可在全部已接入模型之间自由切换。

curl 调用示例

curl https://api.xinshuju.net/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

Python（OpenAI SDK）示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.xinshuju.net/v1"
)

resp = client.chat.completions.create(
    model="deepseek-chat",   # 换个模型名即切换模型
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://api.xinshuju.net/v1"
});

const resp = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);

第三方应用接入

常见 AI 应用的接入方式一致：在设置中找到「OpenAI API 地址 / 自定义接口」填入 https://api.xinshuju.net，再填入令牌即可。适用于 LobeChat、Dify、FastGPT、NextChat、沉浸式翻译等主流应用。

常见问题

调用报 401 怎么办？

检查 Authorization 头是否携带了正确令牌，令牌是否被禁用或超额。

如何查看用量？

控制台「日志」页可查看每次请求的模型、token 数与费用明细。

支持流式输出吗？

支持，设置 stream: true 即可，格式与 OpenAI 完全一致。

模型费率与计费规则见价格说明；平台背景见平台介绍。