第一次接入

不用怕，只有三步：拿 Key、填地址、发一个请求。

一、拿一把 API Key

登录星渊，进 API 密钥 页面，点 添加令牌。

创建时有两个地方值得看一眼：

选项	建议
分组	不选 = 跟随你的账号等级；想用某个专门分组再手动选
模型限制	不限制最省心；只想给插件用某几个模型可以在这里限定

生成的 Key 是 sk- 开头的一长串。它只显示一次，复制下来存好。

顺手存一下

Key 泄漏了要及时删。可以用「额度」和「模型限制」把损失圈住，别嫌麻烦。

二、记下两个值

Base URL : https://api.syuan.org/v1
API Key  : sk-你的密钥

如果客户端让你填 baseURL、apiBase、api_base、OpenAI 接口地址，都是填上面那一行。

关于 /v1

有的客户端会自己补 /v1。如果它已经补了，你在 Base URL 里就不要再写一次，否则会变成 /v1/v1，然后 404。

判断方法：填完之后请求的路径应该长这样 —— https://api.syuan.org/v1/chat/completions。

三、发出第一个请求

curl https://api.syuan.org/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好呀"}],
    "stream": false
  }'

能拿回 choices 就说明通了。

想先确认「这个 Key 到底能用哪些模型」，可以先发一个更轻的请求：

curl https://api.syuan.org/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

返回的 data 里就是你这把 Key 当前真正能调的模型。这份清单比任何文档都准，因为它跟着你的账号等级和令牌限制走。

下一步

• 想知道每个分组有什么区别 → 模型与分组
• 想接特定客户端 → 客户端怎么填
• 已经报错了 → 报错怎么读