跳到主要内容

API key

获取 API Key 与鉴权

为保障您的数据安全与账单清晰，菜AI 平台将"AI 大模型"与"搜索阅读"两大核心业务的 API 密钥（Key）进行了物理隔离。

在开始调用 API 之前，请先了解如何获取并管理您的专属密钥。

1. AI 大模型 API Key (用于调用 LLM、绘画、视频模型)​

该密钥用于访问我们在"模型广场"中提供的所有生成式 AI 模型。

1.1 获取与创建令牌 (Token)​

  1. 登录控制台，在左侧导航栏找到并点击 API key （位于"钱包管理"下方）。
  2. 系统默认为您提供了一个“主 Key”，您可以点击右侧的眼睛图标查看或复制直接使用。 api_2026-03-31_11-23-50.png
  3. 为了更好的安全控制，建议点击页面顶部的 新建令牌，为不同项目生成独立密钥。

PixPin_2026-03-31_12-16-07.png

1.2 核心配置：令牌分组 (Token Groups) 说明​

在新建令牌时，您需要选择 "令牌分组" 。菜AI 提供了极其细致的底层通道划分，帮助您在"极致稳定性"与"极致性价比"之间做出最优选择。

PixPin_2026-03-31_12-17-48.png 分组名称通常由 前缀（模型品牌） + 后缀（底层渠道属性） 构成：

前缀：代表模型品牌

  • gpt: OpenAI 系列 (如 GPT-4o)
  • cl: Anthropic Claude 系列
  • gm: Google Gemini 系列
  • ds: DeepSeek 深度求索
  • qw: Qwen 阿里通义千问
  • db: Doubao 字节豆包
  • vi / kl / ha: Vidu、Kling (可灵)、Hailuo (海螺) 等多模态模型

后缀：代表底层渠道与稳定性

  • -of (Official / 官方直连通道)
    • 特性：100% 官方原生通道或头部云厂商（Azure/AWS）直连。
    • 适用场景：稳定性极高（SLA 接近 100%），企业级生产环境首选。
  • -sp (Special Pool / 特惠并发池)
    • 特性：通过特殊线路优化的资源池，价格大幅低于官方指导价。
    • 适用场景：极高性价比，适合个人开发者、日常代码调试或对成本极度敏感的下沉市场。在极端高峰期可能存在偶发波动。
  • -hs (云服务商通道)
    • 特性：依托国内合规云服务商（如火山引擎）拉取的正规 API。
    • 适用场景：兼顾合规性与稳定性。
  • -cc / -kr / -aws (特定区域通道)
    • 特性：特定第三方或海外节点的细分供应商通道（如 AWS 节点）。
    • 适用场景：满足特定网络路由或定制化需求。

配置建议：生产环境中推荐选择 -of 分组以确保业务连续性；开发测试环境中推荐使用 -sp 分组以大幅缩减研发成本。

2. 密钥安全与高级配置​

在"新建令牌"时，菜AI 提供了一系列企业级风控配置，强烈建议您在投入生产前完成设置：

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

3. 搜索阅读 API Key (用于联网搜索、网页与文档解析)​

该密钥专为搜索、页面结构化读取及文档 OCR 接口提供鉴权。

3.1 获取途径​

  1. 登录控制台，在左侧导航栏找到 搜索阅读产品 模块。
  2. 点击其下方的 API key 。
  3. 在此页面生成和管理的密钥，仅可用于调用 /v1/search、/v1/reader 等搜索阅读专属接口，不可跨产品调用大模型。

下一步骤​

成功获取 API Key 后，您可以：