获取 API Key 与鉴权

数眼智能的「AI 大模型」与「搜索阅读」两条产品线使用相互独立的 Key：

Key 类型	获取位置	可调用的接口
模型 API Key	控制台「AI模型 → 模型 API key」	文本、图像、视频等模型接口（`https://platform.shuyanai.com`）
搜索阅读 Key	控制台顶部切换到「MCP产品」→「接入与密钥」	`/v1/search`、`/v1/reader` 等搜索阅读接口（`https://api.shuyanai.com`）

两类 Key 不能混用。

1. 模型 API Key

登录控制台，在左侧导航点击模型 API key。

系统已默认创建 Key，点击右侧图标即可查看或复制。

建议点击页面顶部的「添加令牌」，为不同项目、成员分别创建 Key，便于单独限额和停用。

新建 Key 时需要选择分组类型，它决定请求被路由到哪个渠道分组：

分组类型	说明
稳定优先	自动选择当前可用性最高的渠道，适合生产环境
价格优先	自动选择当前价格最低的渠道，适合成本敏感的批量任务
指定分组	先选择模型供应商，再手动选择令牌分组，适合需要固定渠道或价格的场景

备注

默认分组 default 按官方原价计费。各模型支持哪些分组、各分组价格多少，可在模型广场点开模型详情查看。

不同账户可见的分组可能不同，请以控制台下拉列表实际显示为准。更多分组信息、大并发或私有化部署需求，请联系商务。

新建或编辑 Key 时，建议在投入生产前按需配置：

设置项	作用
额度	默认不限额（受账户余额限制）。可为 Key 设置固定额度，用完即失效，防止程序异常导致超额消费
过期时间	可快捷设置或自定义，适合临时测试、外包项目
IP 白名单	只允许指定 IP 调用（支持 CIDR）。Key 泄露后，白名单外的 IP 也无法使用

用于联网搜索、网页阅读、文档解析等接口。

登录控制台，在顶部切换到「MCP产品」。

进入接入与密钥，查看 Base URL 与 API KEY。

此处的 Key 仅能调用 /v1/search、/v1/reader 等搜索阅读接口，不能调用大模型。

在 HTTP 请求头中携带 Key：

提示

在 SDK 或第三方工具中填写 Key 时，只填 sk- 开头的原始字符串，不要手动加 Bearer 前缀。不要把 Key 写进前端代码或公开仓库，建议通过环境变量读取。

查看 Base URL，了解各类客户端的地址写法。

把 Key 填入编程工具：开发工具接入。

通过代码发起请求：对话补全 Chat Completions。