API key - ModelPort.AI 接口文档

获取 API Key 与鉴权
为保障您的数据安全与账单清晰，数眼智能平台将“AI 大模型”与“搜索阅读”两大核心业务的 API 密钥（Key）进行了物理隔离。
在开始调用 API 之前，请先了解如何获取并管理您的专属密钥。

AI 大模型 API Key (用于调用 LLM、绘画、视频模型)
该密钥用于访问我们在“模型广场”中提供的所有生成式 AI 模型。
1.1 获取与创建令牌 (Token)

登录控制台，在左侧导航栏找到并点击 API key （位于“钱包管理”下方）。

系统默认为您提供了一个“主 Key”，您可以点击右侧的眼睛图标查看或复制直接使用。

为了更好的安全控制，建议点击页面顶部的新建令牌，为不同项目生成独立密钥。
1.2 核心配置：令牌分组 (Token Groups) 说明
在新建令牌时，您需要选择 “令牌分组” 。DataEyesAI 提供了极其细致的底层通道划分，帮助您在“极致稳定性”与“极致性价比”之间做出最优选择。

分组名称通常由前缀（模型品牌） + 后缀（底层渠道属性）构成：
前缀：代表模型品牌
ds: DeepSeek 深度求索
qw: Qwen 阿里通义千问
db: Doubao 字节豆包
vi / kl / ha: Vidu、Kling (可灵)、Hailuo (海螺) 等多模态模型
后缀：代表底层渠道与稳定性
-of (Official / 官方直连通道)
特性：100% 官方原生通道或头部云厂商直连。
适用场景：稳定性极高（SLA 接近 100%），企业级生产环境首选。
-sp (Special Pool / 特惠并发池)
特性：通过特殊线路优化的资源池，价格大幅低于官方指导价。
适用场景：极高性价比，适合个人开发者、日常代码调试或对成本极度敏感的下沉市场。在极端高峰期可能存在偶发波动。
-hs (云服务商通道)
特性：依托国内合规云服务商（如火山引擎）拉取的正规 API。
适用场景：兼顾合规性与稳定性。
配置建议：生产环境中推荐选择 -of 分组以确保业务连续性；开发测试环境中推荐使用 -sp 分组以大幅缩减研发成本。

密钥安全与高级配置
在“新建令牌”时，数眼智能提供了一系列企业级风控配置，强烈建议您在投入生产前完成设置：
额度设置 (Quota Limit)：
默认情况下令牌无额度限制（受限于账户总余额）。您可以为下发给团队成员或特定工具的 Token 设置固定总额，超出该额度 Token 即失效，有效防止代码死循环造成的资金损失。
过期时间 (Expiration)：
可一键设置为“一个月”、“一天”或自定义具体时间，适合为短期外包项目或临时测试分配密钥。
访问限制 (IP Whitelist)：
支持绑定指定的服务器 IP 地址。即使密钥意外泄露，非白名单内的 IP 也无法发起调用，从根本上杜绝恶意盗刷。

搜索阅读 API Key (用于联网搜索、网页与文档解析)
该密钥专为搜索、页面结构化读取及文档 OCR 接口提供鉴权。
3.1 获取途径

登录控制台，在左侧导航栏找到搜索阅读产品模块。

点击其下方的 API key 。

在此页面生成和管理的密钥，仅可用于调用 /v1/search、/v1/reader 等搜索阅读专属接口，不可跨产品调用大模型。

下一步骤#
成功获取 API Key 后，您可以：
浏览 Base URL。
将 Key 和 Base URL 填入您的 AI 编程助手，查阅开发工具接入指南。
通过代码发起请求，查阅文本对话 (Chat Completions) 接口文档。