通用工具接入 dataeyesAI (OpenAI 兼容协议)

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

一、通用配置“三要素”

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

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

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

注意：由于 Cursor 的产品限制，Cursor 免费版仅支持Auto模式，且不支持调用自定义模型。如需要自定义，请升级至Cursor Pro 及以上套餐，即可正常使用 dataeyesAI 支持的模型。

打开 Cursor，进入 Settings -> Models。

找到 OpenAI 配置项，打开 Override OpenAI Base URL 开关，填入 https://cloud.dataeyes.ai/v1。

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

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

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

(图例参考)

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

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

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

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

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

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

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

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