Skip to main content

概览

该接口用于更新已有用户 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
取值为 activeinactiverevoked
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 时间戳。