
如果你只是有计划地临时停用,并且仍信任这份凭据,可以暂停 Imagild API 密钥;如果凭据已经泄露或确定永久停用,则应撤销。已暂停的密钥在满足其他使用条件时可以恢复,已撤销的密钥无法还原。两种操作都不会取消已经受理的生成任务,也不会自动退回该任务的积分。
请使用密钥所属账号,在 Imagild API 控制台中根据密钥名称或脱敏前缀作出判断。不要让完整密钥出现在截图、支持工单或浏览器代码中。
要点
- 暂停可以恢复;撤销意味着永久停用这份凭据。
- 暂停后,这份密钥在恢复前无法为正常的 API 读取或写入请求通过身份验证,即使任务已经存在也是如此。
- 恢复密钥后,仍需分别核查到期时间、会员资格和任务计费。
根据实际情况选择,不只看错误消息
| 情况 | 合适的下一步 | 重要边界 |
|---|---|---|
| 计划维护,且密钥仍然可信 | 暂停对应密钥 | 已受理任务仍需核对结果与计费 |
| 密钥出现在公开仓库或共享日志中 | 按安全流程撤销并替换 | 隐藏眼前的副本不会让已复制的密钥失效 |
| 已退役的应用不再需要访问 | 核查依赖后撤销其凭据 | 不要误停其他仍在使用的集成 |
| 控制台显示“已过期” | 安排经授权的密钥替换 | 恢复操作不会延长到期时间 |
| 会员资格不再允许使用 API | 解决账号的访问条件问题 | 密钥有效不等于账号具备会员资格 |
如果发生泄露,请遵循凭据泄露处理指南。如果他人已经复制过密钥,临时暂停之后,你仍然握有一份不应再信任的凭据。本文不建议恢复已经泄露的密钥。
暂停和恢复正确的密钥
打开控制台,确认账号、环境、密钥名称和前缀都正确。如果密钥较多,可以使用名称或前缀搜索及状态筛选。如果密钥早于当前已加载的历史范围,请先加载更早的密钥,再判断它是否缺失。
对于可信且未过期的密钥,请在对应行选择暂停。等待操作完成,确认该行显示已暂停。如果应用依赖这份密钥,请在自己的运维记录中记下变更。
计划停用结束后,选择恢复,并确认当前行状态。到期时间和会员条件仍然适用;恢复操作不会为其中任何一项续期。到期监控指南另行说明了替换规划。
例如,假设某个团队在维护期间暂停预发布环境应用的密钥。恢复前,他们会核查部署仍然读取预期的密钥存储条目,并确认没有泄露报告。他们不会仅为证明暂停按钮改变了状态,就生成一张生产图片。
谨慎撤销,并保留任务编号
确定需要撤销时,先找到正确的行,选择撤销,再核对明确的确认撤销操作。确认前,请检查哪个部署正在使用这份密钥。提交确认之前,控制台还提供取消操作。
撤销后,确认该行显示已撤销,并从应用的当前配置中移除这份已停用凭据。如果应用需要继续运行,应由经授权的人员安全配置替代密钥。历史记录中的脱敏值无法还原丢失的完整密钥。
变更期间,请保留原任务 ID 和请求记录。撤销密钥不会删除已经生成的媒体;撤销凭据与删除数据的区别另行说明这个问题。
理解已经受理的任务会怎样
密钥管理控制后续请求的身份验证和受理,不会撤回服务已经接受的任务。该任务仍可能继续处理、产出结果,或需要按原报价核对计费。
暂停也会阻止使用该密钥进行需要身份验证的状态查询和下载。因此,读取失败并不能证明生成失败。请使用账号支持的历史记录视图调查,或在安全条件下恢复合适的授权访问。不要仅因为旧密钥现在返回访问错误,就换新密钥重复提交生成。
会员与积分指南说明了为什么单独恢复凭据不一定能解决账号级访问问题。
不新建付费任务,也能核实变更
检查可见密钥状态,以及应用配置所引用的凭据。如果需要检查访问权限,请使用文档规定的只读操作,而不是生成请求。保留准确的返回错误与时间,分清凭据访问问题和任务最后已知状态。不要把 Bearer 凭据值放入诊断记录。
来源与适用范围
这份公司指南介绍当前 API 控制台及文档记录的密钥管理行为,核对日期为 2026 年 10 月 30 日。本文是操作原理说明,不代表在生产凭据上实际执行过每一种生命周期操作。编写过程中未创建、暂停、恢复或撤销线上密钥。
由 Imagild Editorial编写,该公司编辑团队负责本系列指南。AI 参与了资料研究和起草。反馈更正。
封面:AI 生成的概念插图;并非应用截图、实测结果、私人账号记录或隐私保证。