概览
该接口用于更新已有用户 API Key 的名称、额度、模型白名单、过期时间或状态。请求体
PATCH 请求至少需要提供一个字段。说明
-
金额字段仅支持 USD。
CNY输入已停用,并会返回400 currency_retired。 - Management API v1 故意不支持硬删除。
-
revoked更适合作为终态使用;如需恢复,通常建议新建一个 Key,而不是依赖后续“解封”流程。
示例
请求 / 响应
精确 schema 和响应字段请使用上方的交互式 OpenAPI 面板。响应示例
重要字段
string
用于后续管理 API 调用的 API Key 标识符。
string
API Key 的显示名称。
string
用于展示和支持排查的非敏感 Key 前缀。
string
取值为
active、inactive 或 revoked。number | null
以 JSON 数字返回的 USD 消费上限,用于展示。
null 表示不限额。string | null
以十进制字符串返回的 USD 精确消费上限。
null 表示不限额。number
以 JSON 数字返回的 USD 累计用量消费,用于展示。
string
以十进制字符串返回的 USD 精确累计用量消费。
string[]
单个 Key 的模型白名单。空数组表示没有额外的 Key 级模型限制。
string | null
Key 到期时间的 ISO 时间戳;
null 表示永不过期。string | null
最近一次使用的 ISO 时间戳;从未使用时为
null。string
创建时间的 ISO 时间戳。