| Key 类型 | 获取位置 | 可调用的接口 | 计费 |
|---|
| 模型 API Key | 控制台 → 模型 API key | 文本、图像、视频、语音等所有模型接口（https://studio.dataeyes.ai） | 按模型用量从模型余额扣费 |
| 搜索阅读 Key | 控制台 → MCP产品 → 接入与密钥 | 搜索、阅读、文档解析等接口（https://openapi.dataeyes.ai） | 按调用次数扣减 |
模型 API Key#
创建 Key#
注册后，系统会自动为您创建 3 个 Key，分别对应三种分组类型，可直接使用。如需为不同项目、成员或环境分开管理，在 模型 API key 页面点击「新建」。分组类型#
新建 Key 时需要选择分组类型，它决定请求被路由到哪个渠道分组：| 分组类型 | 说明 | 适用场景 |
|---|
| 稳定优先 | 自动在可用分组中优先选择可用性最高的渠道 | 生产环境 |
| 价格优先 | 自动在可用分组中优先选择价格最低的渠道 | 成本敏感的批量任务 |
| 指定分组 | 固定使用您选择的分组 | 需要锁定价格或渠道时 |
default（官方原价）：所有模型可用，按官方原价计费。
品牌分组（如 gemini、openai、claude-aws 等）：对应品牌的模型享有折扣，折扣以模型详情页「分组价格」为准。
安全设置#
额度上限：为 Key 设置可消耗的美元上限，超出后自动失效，防止程序异常导致超额消费。
IP 白名单：只允许指定 IP 调用（每行一个，支持 CIDR），Key 泄露后也无法被盗用。
模型限制：可选，限制该 Key 只能调用指定模型；一般无需开启。
搜索阅读 Key#
在控制台顶部切换到「MCP产品」，进入 接入与密钥，即可看到 Base URL 与 API KEY。完整 Key 只在创建账号或「轮换」时显示一次，之后列表只显示首尾几位。请及时保存；忘记时只能点击「轮换」生成新 Key，旧 Key 随即失效。
在请求中传递 Key#
所有接口均需通过 HTTPS 调用。不同协议使用各自的标准请求头，网关全部支持：| 协议 | 请求头 | 示例 |
|---|
| OpenAI 兼容（含搜索阅读接口） | Authorization | Authorization: Bearer sk-xxx |
| Anthropic Messages | x-api-key 或 Authorization | x-api-key: sk-xxx |
| Gemini 原生 | x-goog-api-key | x-goog-api-key: sk-xxx |
在 SDK 或第三方工具里填写 Key 时，只填 sk- 开头的原始字符串，不要手动加 Bearer 前缀，SDK 会自动处理。
安全建议#
不要把 Key 写进前端代码、移动端安装包或公开仓库；推荐通过环境变量读取，例如 export DATAEYES_API_KEY=sk-xxx。
为不同项目使用不同的 Key，便于单独限额、停用和对账。
怀疑 Key 泄露时，立即在控制台删除或停用该 Key，并新建一个替换。
下一步#
