服务地址#
| 服务 | Base URL | 说明 |
|---|
| AI 模型 API | https://studio.dataeyes.ai | 文本、图像、视频、语音等全部模型接口 |
| 搜索与阅读 API | https://openapi.dataeyes.ai | /v1/search、/v1/reader、/v1/document/parse 等 |
| 账户查询接口 | https://www.dataeyes.ai/apex | 余额、用量、Key 管理等,见 余额与用量查询 |
platform.dataeyes.ai、cloud.dataeyes.ai、api.dataeyes.ai 属于企业版(www.dataeyes.vip),个人版的 Key 在这些地址上会返回「无效的令牌」。
什么时候加 /v1#
这是接入时最常见的错误。规则只有一条:OpenAI 兼容的客户端加 /v1,Anthropic 和 Gemini 的客户端不加。| 客户端 / SDK | 应填写的 Base URL |
|---|
| OpenAI SDK(Python / Node.js / Go / Java 等) | https://studio.dataeyes.ai/v1 |
| Codex、Cursor、Cline、OpenCode、OpenClaw、n8n、Chatbox 等 OpenAI 兼容工具 | https://studio.dataeyes.ai/v1 |
| Anthropic SDK、Claude Code | https://studio.dataeyes.ai |
| Google GenAI SDK、Gemini CLI | https://studio.dataeyes.ai |
| 直接发 HTTP 请求(cURL、Postman) | 写完整路径,如 https://studio.dataeyes.ai/v1/chat/completions |
如果某个工具填 /v1 报 404,去掉 /v1 再试;反之亦然。工具会在 Base URL 后自动拼接路径,多一层或少一层 /v1 都会导致 404。
SDK 示例#
请求约定#
数据格式:除文件上传类接口使用 multipart/form-data 外,请求与响应均为 JSON,请带上 Content-Type: application/json。
流式输出:在请求体中设置 "stream": true,响应以 Server-Sent Events(SSE)格式返回。
超时:推理模型和长文本生成可能耗时数分钟,建议客户端读超时不低于 600 秒;视频等异步任务请使用「提交任务 + 轮询查询」的方式。
请求体大小:单次请求体上限为 128 MB。图片、视频等大文件建议传公网 URL,而不是 Base64。
User-Agent:服务前置了安全防护,请保留 SDK 默认的 User-Agent。若自行发起 HTTP 请求返回 403,请为请求设置一个 User-Agent。
下一步#
开发工具接入:Claude Code、Codex 等工具的完整配置。