通用请求说明 (Base URL & 鉴权)

在发起 API 请求之前，请了解我们平台针对不同业务线的全局网络端点（Base URL）以及标准的鉴权方式。

1. 基础请求地址 (Base URL)

为了保障底层计算资源的物理隔离与极速响应，数眼智能为“AI 大模型”与“搜索阅读”分配了不同的独立端点。请根据您调用的产品选择对应的 Base URL。

无论您是集成到第三方工具（如 ClaudeCode、OpenClaw），还是在服务器上发起代码请求，我们建议的节点如下：

节点类型	Base URL	适用场景说明
国内直连	`https://platform.shuyanai.com`	推荐默认使用，极速稳定。
国际推荐	`https://cloud.shuyanai.com`	国际加速

提示： 在大多数 AI 客户端（如 Chatbox）或编程插件中，只需将 Base URL 或 API Endpoint 字段填写为上述地址即可（注：部分插件可能要求在末尾补全 /v1，请视具体插件提示而定）。

当您调用 /v1/search、/v1/reader 等专用的数据获取接口时，请务必使用以下独立端点：

https://api.shuyanai.com

(注意：调用此端点时，必须搭配在“搜索阅读产品”版块生成的专属 API Key 使用)

数眼智能全局接口均支持 HTTP 和 HTTPS，并采用行业标准的 Bearer Token 方式进行权限校验。

您需要在每一个 HTTP 请求的 Header 中携带您对应的 API Key。

Header 格式示例：

(注意：Bearer 和您的 Key 之间必须有一个空格)

除了特定说明的接口（如文件上传），我们在请求和响应中均使用 JSON 格式。请确保在您的请求 Header 中包含：

现在您已经掌握了对应产品的 Base URL 和鉴权方式，接下来您可以：

前往查阅具体的开发工具接入，将您的 Key 和 Base URL 填入开发工具中。

或直接开始通过代码调用文本对话 (Chat Completions) 接口。