通用工具接入数眼智能 (OpenAI 兼容协议)

数眼智能的接口完美兼容标准的 OpenAI API 协议。这意味着，只要你使用的工具支持自定义 OpenAI 节点（如 ClaudeCode、Chatbox、各类 VS Code 插件等），你都可以轻松将底层模型替换为数眼智能的高性能算力。

一、通用配置“三要素”

无论你使用的是什么工具，找到其“设置 / API Configuration / Custom Provider”页面，替换以下三个核心参数：

配置项	填写内容	避坑指南
API Base URL (或接口地址)	`https://platform.shuyanai.com/v1`	⚠️ 关于 `/v1` 的重要说明：绝大多数工具（如 Cursor）需要带 `/v1`。但部分工具如果报错“404”或“无效 URL”，请删掉 `/v1` 仅保留根域名再试。
API Key (或密钥)	`sk-xxxxxxxxxxxxxxxx`	请直接填写数眼智能控制台获取的纯文本，不要手动添加 `Bearer` 前缀。
Model (或模型名称)	填写数眼智能实际支持的模型名	务必与数眼智能控制台展示的名字一字不差（如 `deepseek-v3.2-exp`）。

以主流 AI 编程工具 Cursor 为例：

打开 Cursor，进入 Settings -> Models。

找到 OpenAI 配置项，打开 Override OpenAI Base URL 开关，填入 https://platform.shuyanai.com/v1。

在 API Key 处填入你的 DataEyes sk-... 密钥。

点击 Add Custom Model，输入你想使用的模型名（如 deepseek-v3.2-251201）并开启开关。

在对话框选中该模型即可开始使用。

如果你在配置后无法正常对话，请按以下顺序排查“三大经典报错”：

1. 报错 404 (Not Found) / Invalid URL / 模型不存在？
这是最常见的路径或名称拼接错误：

Base URL 结尾问题：这是不同工具的底层逻辑差异导致的。如果你填了 /v1 报错，请删掉 /v1 再试；如果没填报错，请加上 /v1 再试。

模型名问题：不要凭直觉填写，必须确保填写的模型名在数眼智能平台真实存在且你拥有调用权限。

2. 报错 401 (Unauthorized) / 认证失败？

检查 Key 是否多复制了空格，或者画蛇添足地加上了 Bearer 前缀。

登录数眼智能控制台确认该 API Key 的状态是否正常、额度是否充足。

3. 报错 502/504 / 网络连接超时？

可能是当前主网路由波动。请尝试将 Base URL 替换为其他官方备用节点（如 https://cloud.shuyanai.com/v1）。