智森3Dai助手
开始对话 返回首页

API 开放服务

OpenAI 兼容接口已上线:任何支持 base_url 的客户端、SDK、Agent 框架都能直接接。目前不限制调用次数,Key 必须先绑定角色。

POST /v1/chat/completions

对话补全

OpenAI 协议,支持 stream(SSE)。自动带角色人设与永久记忆。

GET /v1/models

模型列表

返回可用 model 名,默认 agnes(后台主通道)。

POST /api/openai/keys

创建 Key

需先登录并已有角色;Key 只显示一次,库里只存国密哈希与密文。

三步接入

1)创建角色(没有角色不能签 Key)→ 2)点下方「获取 API Key」→ 3)把 base_url 指向 https://yutongguoji.cn/v1

curl https://yutongguoji.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-sen-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"agnes","messages":[{"role":"user","content":"你好"}]}'
# OpenAI Python SDK
from openai import OpenAI
client = OpenAI(base_url="https://yutongguoji.cn/v1", api_key="sk-sen-...")
print(client.chat.completions.create(model="agnes",
      messages=[{"role":"user","content":"你好"}]).choices[0].message.content)

stream=True 同样可用;支持 model 别名 gpt-3.5-turbo,方便只认 OpenAI 名字的老客户端。

密钥与额度

不限制调用次数。Key 用 国密 保管:库中存 SM3 哈希用于校验、SM4 加密副本用于后台查看,明文只在创建时返回一次。删除角色后该 Key 立即失效。

快速接入 QQ

把 QQ 小号绑定到本账号后,可以直接在 QQ 里和角色聊天,永久记忆与网页端共用。

扫码绑定需要服务端先跑一个 QQ 协议端(NapCat / Lagrange),这块正在接;当前可用的是官方 QQ 机器人 webhook(见「QQ 机器人设置」)。