· reAPI Team
API 密钥泄露:阻止未经授权的使用和扣费
控制 API 密钥泄露,区分新请求用量与待结算费用,安全替换暴露的凭据,并准备账单复核所需的证据。

立即在服务商的账户控制台撤销暴露的密钥,并记录时间。让凭据失效之后,再调查截图、代码仓库或日志条目。
删除密钥出现的位置,并不会让别人已经持有的副本失效。正因如此,GitHub 的指南建议先撤销或轮换凭据,再清理仓库。[1] 如果应用正在使用该密钥,更换时预计需要协调。应用仍在正常运行,并不是让已知泄露的凭据继续有效的理由。
从平时使用的账户登录入口开始
使用常用书签或已知的服务商账户地址,不要点击声称发现泄露的消息中的链接。根据可安全使用的标识符或标签找到受影响的凭据,并使用文档说明的撤销或禁用功能。无需将完整密钥粘贴到事件记录中。
在 reAPI 上,撤销会阻止使用该密钥发起新请求。仍持有它的应用需要更换密钥。身份验证文档还说明,待处理任务在撤销后仍可继续完成并消耗积分。[2] 因此,在撤销后立即查看余额时,后一条行为很重要。
分别检查自动充值和未完成任务这两项控制。如果决定关闭自动充值,要确认该设置实际会阻止什么。它不会撤销 API 凭据、取消已接受的任务,也不能单独解释某笔扣费。如果服务商支持取消,请检查任务的确认结果和计费规则,不要假定点击“取消”就能让任务免费。
此时保持记录简短:受影响的账户、凭据标签、发现时间和撤销时间,并注明时区。之后可以继续详细调查。等到报告完美才行动,会让暴露的凭据多存活一段时间。
为什么撤销后余额仍可能变化
假设某个生成任务在 09:01 被接受,你在 09:03 撤销暴露的密钥,而任务在 09:07 完成。这只是用于说明的时间顺序,并非已报告的事件。按照 reAPI 文档中对待处理任务的说明,先前的任务仍可完成并消耗积分。任务契约也将提交时的预留与最终结算分开。[2][3]
仅凭 09:07 的结算,不能认定该密钥在 09:03 之后通过了新请求的身份验证。请检查任务何时被接受。这个时间戳所回答的问题,与处理何时结束或何时出现扣费不同。
也不要反过来想当然。如果一个不熟悉的请求在你记录的撤销时间之后被接受,仍需调查。检查其他有效凭据、当前查看的账户或组织,以及能在那里提交任务的应用或人员。如果现有记录无法确定凭据或接受时间,就将这部分保留为未知,并请支持团队协助查明。
对于每个可疑请求,在信息可用时保留其 ID、模型或端点、接受时间、完成时间和结算金额。补充说明应用是否能识别该请求。目标是区分已知任务与无法解释的任务,而不是根据余额下降来证明某种猜想。
面临风险的金额也可能不同于已结算金额。按照平台契约解读预留金额和最终用量字段。在 reAPI 上,结算用量为零的处理中任务尚未完成计费;这个零不能证明先前的预留已退回。[3] 在结果明确之前,持续关注尚未解决的任务。
在实际使用密钥的进程中更换它
通过服务商已登录的管理后台创建替代密钥,并通过应用的密钥管理机制保存。reAPI 文档说明可在 API Keys 设置中创建密钥,并建议为不同环境和服务使用独立凭据。[2] 为替代密钥标明清晰用途,避免下次轮换时重新查找所有使用方。
将它部署到受影响的使用方之前,先堵住已知的泄露路径。如果该进程将凭据发布到前端构建产物,或打印到共享日志中,就先修复该路径。完整调查可以随后继续;不应通过已知会泄露密钥的机制传递替代密钥。
接着沿着凭据的使用路径检查应用。检查 Web 服务、后台工作进程、定时任务以及调用该 API 的任何自动化流程。只有本地开发和 CI 使用该凭据时,才将它们纳入检查。目的是找到真正读取该秘密信息的地方,而不是列出一长串你根本没有运行的系统。
设想轮换后网站恢复运行,但某个后台工作进程的 API 调用仍返回身份验证错误。这是假设的排查案例。成功的 Web 请求证明某一个进程配置有效,却无法说明独立工作进程的环境情况。在创建另一个密钥之前,先检查失败的工作进程实际加载了什么。
验证配置时不要打印密钥。使用安全标签、配置中记录的密钥引用,以及应用现有的验证流程。仅为检查替代值是否已提供给进程,无需发起不熟悉的付费生成任务。
对于 reAPI 身份验证错误,检查文档中的 Bearer 请求头要求和实际错误响应。凭据无效或已撤销,与余额不足及端点错误是不同情况。[2] 如果新密钥有效,但账户无力支付所请求的任务,再次轮换也无法解决余额问题。
将服务端凭据保留在服务端。Google 的密钥管理指南提醒不要在客户端代码中嵌入密钥,GitHub 也建议更安全地处理凭据,以防再次泄露。[4][1] 不能仅因为这样能让最简短的教程示例运行,就把替代密钥藏在浏览器构建包或分发给用户的移动应用中。
查明这份副本是如何泄露的
旧凭据失效、合法使用方获得替代密钥后,再回头检查泄露的副本。检查可能将它发布出去的具体路径:仓库历史、构建后的前端资源、CI 日志、计算笔记本、截图或共享的故障排查输出。
如果它出现在 Git 仓库中,删除当前文件只是清理工作的一部分。GitHub 说明,敏感内容可能仍存在于历史记录、分叉和克隆中。[1] 任何历史清理工作都应与仓库使用者协调。撤销解决的是被复制的凭据;清理则减少这些位置的持续暴露。
如果它出现在日志中,找到打印它的代码。只删除一条日志,却让同样的日志输出路径继续有效,可能会在应用下次报错时泄露替代密钥。除了成功请求,也要检查常规故障排查流程的输出:出错时人们复制的材料中可能包含密钥。
如果它出现在截图或共享工作流中,用脱敏版本替换这些材料,并检查工作流中是否仍包含旧值。不要要求同事把泄露的密钥发回给你,以证明他们已将其删除。通过凭据的安全标签以及受影响文件或消息的位置跟踪清理工作。
将调查发现与责任归属分开。应用日志中缺少某个请求,只能证明这些日志无法解释它,不能证明是谁发送了请求,或对方从哪里获得凭据。记录能够确认的暴露情况和能够识别的流量,其余部分留待调查。
在控制措施适用时限制替代密钥
Google 建议为应用或团队使用独立凭据,设置适当限制并开展监控。[4] 应用于轮换时,这意味着在服务商支持相应限制的情况下,只授予后台图像工作进程所需的权限,而不是习惯性地重新创建一个广泛共享的凭据。
各平台提供的控制不同。fal 文档列出了权限、到期时间和允许使用的模型设置。OpenRouter 的 Security Center 文档说明了支出和到期控制,并区分禁用密钥与归档密钥;其 IP 允许列表是 Enterprise 功能。[5][6] 依赖某个选项之前,先检查你账户实际提供的该选项的作用范围。
对于支出限额,要确认它限制的是凭据、账户、充值行为还是其他数值,以及已接受的任务会如何处理。对于到期设置,要确定哪些应用需要在该日期前更换密钥。对于模型限制,要验证它仍允许合法任务运行。了解某项控制能遏制哪种故障时,这项控制才有用。
指定人员处理异常用量提醒。通知可以提醒你调查;但响应仍需要有人能够识别并撤销受影响的凭据。将负责人信息与密钥用途放在一起。发生事件时,这比一份用途不明的旧凭据名称列表更易使用。
事件之后,更换 API 服务商可以作为独立的产品决策。但这不会让旧服务商处仍有效的密钥失效,也不能修复会把下一个服务端密钥放进同一公开构建包的应用。
将未解决的问题提交给支持团队
根据已建立的时间线准备账单请求。包括账户或项目、可安全展示的凭据标识符、可疑活动时间范围、撤销时间和请求 ID。附上相关扣费记录,以及服务商所需的收据标识符。不要将 API 密钥、银行卡详情和客户私有文件放进公开工单或截图中。
你可以围绕仍需确认的事实组织请求:
我们已于[时间和时区]撤销受影响的凭据。随附的请求列表区分了应用能够识别的活动与我们无法解释的活动。请确认其中是否有请求在撤销后被接受,解释先前待处理任务的结算情况,并复核有争议的费用。
填写记录能够支持的信息。如果缺少接受时间戳或凭据关联,就如实说明,不要编造。列出已采取的措施,以便支持团队区分仍在持续的访问与仍需核对的账单。
安全调查与账单调整是两个不同的结果。发现泄露或提交工单,并不意味着费用会被退回。在服务商回答具体请求并解释任何调整之前,继续跟进复核。同时,可以分别依据各自的记录,检查应用的替代凭据、修复后的泄露路径和未完成任务。
参考资料
- GitHub。*从仓库中移除敏感数据。*查阅于 2026 年 11 月 15 日。GitHub 安全指南。
- reAPI。*身份验证参考。*查阅于 2026 年 11 月 15 日。身份验证文档。
- reAPI。*任务参考。*查阅于 2026 年 11 月 15 日。任务生命周期与结算。
- Google Cloud。*管理 API 密钥的最佳实践。*查阅于 2026 年 11 月 15 日。Google Cloud 身份验证指南。
- fal。*基于密钥的身份验证。*查阅于 2026 年 11 月 15 日。
- OpenRouter。*通过全新 Security Center 管理 API 密钥并降低风险。*发布于 2026 年 9 月 28 日;查阅于 2026 年 11 月 15 日。