Skip to main content

接入认证

了解 API Key 的用途、创建步骤、调用认证、费用与安全注意事项

什么是 API Key

API Key 是调用法睿开放能力的凭证,用于接口鉴权。您可以从控制台左下角头像菜单进入「API Key」页面创建和管理,每把 Key 都可独立启用、停用和删除。 您可以为不同应用分别创建 API Key,分开统计费用消耗,便于管理与追踪。

如何获取 API Key

创建前请切换到个人身份,新建或关联的 Key 固定绑定当前个人身份。已有 Key 可在管理页关联,使用前请确认已启用。历史团队 Key 可在管理页停用或删除。
1

进入 API Key 页面

点击控制台左下角头像,在展开的菜单中选择「API Key」,进入页面后点击右上角「创建 API Key」。

在左下角头像菜单中选择「API Key」

法睿控制台左下角头像菜单,红框标出 API Key 入口

在 API Key 页面点击「创建 API Key」

API Key 管理页面,显示创建 API Key 和开放平台按钮、安全提示及列表表头
2

填写名称

按应用或用途填写便于识别的 API Key 名称,方便后续管理。API Key 标识由系统生成,不可修改。
3

选择过期时间

过期时间支持 1 天、7 天、30 天、90 天、永不过期与自定义。填写完成后创建 API Key。

创建表单中的名称、标识和过期时间,名称为示例

创建 API Key 弹窗,显示示例名称、系统生成的标识和过期时间选项
4

立即复制并保存密钥

完整密钥仅在创建成功时展示一次。请立即复制并妥善保存,关闭展示窗口后无法再次查看或复制完整密钥。

API Key 创建成功页。图中的预发测试 Key 已删除。

完整的创建成功面板,显示进度、ID、名称、API Key、过期时间、复制按钮和关闭页面按钮

使用 API Key 发起调用

  1. 确认可用条件:确认 Key 已启用,当前身份具有目标 API、MCP Server 或 Agent 的访问权限,并满足目标能力的订阅或积分要求。
  2. 配置客户端:根据接入方式选择下方指南,结合控制台接入信息配置服务地址、请求头和认证方式,再发起调用。

API 与 Agent 的认证请求头

API 和 Agent(A2A)的 HTTP 请求携带以下认证请求头:
请求头填写说明
Authorization填写 API Key 原文,省略 Bearer 前缀
x-acs-date填写发起请求时的 UTC 时间,使用 ISO 8601 格式,精确到秒并以 Z 结尾,例如 2026-11-10T08:00:00Z。每次请求重新生成
x-acs-date 示例只用于说明格式,不要直接复制为固定值。macOS/Linux 可使用 date -u '+%Y-%m-%dT%H:%M:%SZ' 生成当前时间;重试时也要重新生成。
API 版本和请求体格式见 API 接入指南及 Agent 接入指南。

MCP 客户端的认证配置

MCP 客户端使用 Authorization 传入个人 API Key 原文,省略 Bearer 前缀,并配置 x-acs-version: 2026-10-19。具体客户端配置见各 MCP 服务配置页。

费用说明

使用 API Key 发起的调用统一按实际用量折算扣减订阅积分,没有单独的接口单价,也不需要单独开通服务。积分不足时调用会被拒绝,可购买加油包补充。 在左下角头像菜单的「积分用量」页面,可按消耗渠道与消耗方式逐条查看消耗记录。积分使用与记录核对方法见计费与用量。

凭据安全

API Key 具有账户的完整访问权限,请妥善保管,不要泄露给他人,也不要硬编码在前端或提交到公开仓库。
  • API Key 及其他接入凭据只应保存在服务端或密钥管理系统中,不要写入日志或工单。
  • 建议按应用场景分别创建 API Key,便于管理与追踪。
  • 怀疑凭据泄露时,请立即在控制台撤销并重新创建,同时更新使用该凭据的应用。

认证失败时查看错误与排障

按 API、MCP 或 A2A 的响应形态定位问题,并核对控制台中的凭据与访问权限。