跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

API Key 管理

为应用或智能体创建密钥,保存并检查访问,管理其生命周期。

本页内容

1. 创建密钥

  1. 登录已验证账户,打开 API Keys。已有授权密钥时可直接复用。
  2. 以应用和环境命名,选择有效期及所需来源。首次搜索示例选择 Google Search。
  3. 创建密钥并按下方方式保存。独立智能体和生产应用分别使用密钥,以便单独撤销。

2. 保存密钥

选择运行 FlashData 的方式。API 与 SDK 示例读取 FLASHDATA_API_KEY;CLI 可将密钥保存到受保护配置。生产环境从密钥存储注入凭据。

为当前终端设置密钥
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY

3. 验证访问

在同一终端或 CLI 配置运行免费检查,选择与密钥保存方式对应的选项卡。

在同一终端复用前面检查时设置的 FLASHDATA_API_KEY。

读取账户 JSON
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)

确认账户与来源

HTTP 直接返回这些字段。CLI JSON 将其放在 data.identity.identity 中,还应检查 data.accessVerified: true。

检查项预期
accountId此工作负载所属账户。
accessready
scopes首次搜索需包含 google_search。
recurringAllowed定时所有者任务前应为 true。

来源权限如何生效

密钥只能使用获授来源。产品选择与定价独立,账户全部密钥使用共享余额,包括购买的 Credits。受限密钥没有独立消费上限,未来产品需要明确授权。

密钥泄露时

  1. 立即在下方对应控制台页面撤销已泄露密钥,并停止其定时调用方。
  2. 创建具有所需权限的替换密钥,安装到各调用方的密钥存储,再运行上方免费验证。
  3. 检查 History 与账户用量中的异常活动。从文件中删除密钥不会撤销密钥。

轮换密钥

  1. 创建具有所需来源的替换密钥,安装到目标环境。
  2. 重复上方免费验证,再切换应用或调度器。更新每个预期调用方。
  3. 调用方切换后撤销旧密钥。修改本机密钥不会更新已部署服务。
替换 CLI 密钥 · 在隐藏提示输入
flashdata auth login --replace
flashdata auth status

撤销访问

停止定时调用方,在下方对应位置撤销密钥或连接,再以旧凭据重复免费验证,确认请求被拒绝。本地退出登录不会撤销服务器访问。

访问类型撤销位置
普通 API KeyAPI Keys
已认领智能体密钥Settings → Connected apps → Agent connections
MCP OAuth 授权Settings → Connected apps