基础工具 · 第 3 天

API Key 是什么？

API Key 是工具调用模型时用来证明身份的钥匙。小白最容易把它当登录密码乱贴，或者不知道该填在哪个配置项里。

今天完成什么

能安全管理第一把 API Key。

创建一个测试 Key并记录用途，优先存入工具官方凭据存储、系统 keyring 或部署平台 Secret；环境文件必须受保护且已被 Git 忽略。

操作步骤

  1. 先确认接入方式：订阅登录用户只做字段识别练习，不必新建 Key；选择 API 路线后，才在所选平台创建用途明确、额度受限的专用 Key。
  2. 优先使用工具官方凭据存储、系统 keyring 或部署平台 Secret；必须用环境文件时，先限制权限并加入 .gitignore。
  3. API 路线确认费用和权限后，再用一次最小请求验证；订阅路线检查登录状态，不重复购买 API 额度。

教学样例

假设你选择了 API 路线，工具要求填写接口地址、模型名和凭据。练习记录字段名与存储位置，不填写真实 Key。

参考结果

  • Base URL：引用对应工具的当前接入文档，确认是否需要 /v1。
  • 模型：从当前密钥可用列表选择，不把示例名称当库存。
  • 凭据：只记录使用官方凭据存储或 Secret，不截图、不粘贴其值。
  • 选择订阅登录的用户可跳过创建 API Key，不把两种计费混为一谈。

任务模板

请检查我的 API Key 接入清单是否完整。工具：{工具名}；需要填写的字段：{字段列表}；我想确认 Key、BASE_URL、模型名分别应该放在哪里。不要要求我提供完整密钥。

检查结果

  • 能区分订阅登录与 API 接入，知道本次使用哪一种。
  • 没有把完整 Key 发到群聊、网页、仓库。
  • API 路线完成受控的最小验证；订阅路线完成字段识别与登录检查。

今天留下的是一份安全的 API Key 配置清单。

卡住时先看

第一次用 Cursor、OpenClaw、Chatbox 或 Bot 时卡在填 Key。