跳转到主要内容

​
概览

该接口用于更新已有用户 API Key 的名称、额度、模型白名单、过期时间或状态。

​
请求体

PATCH 请求至少需要提供一个字段。
字段类型默认值 / 限制说明
statusenum-active、inactive、revoked
namestring长度 1-50更新后的展示名称
limitAmountnumber | null最小 0，最大 100000null = 不限额，0 = 零额度，正数 = 美元上限
limitCurrencyenum默认 USD可选：USD 或 CNY。当设置为 CNY 时，limitAmount 会按人民币理解，并在服务端按当前汇率换算成 USD 后存储
modelsstring[]-更新后的逻辑模型白名单
expiresAtstring | nullRFC3339 datetimenull 表示清除过期时间

​
说明

  • Management API v1 故意不支持硬删除。
  • revoked 更适合作为终态使用；如需恢复，通常建议新建一个 Key，而不是依赖后续“解封”流程。
  • 响应会额外返回 exchange_rate，以及人民币展示字段 limit_amount_cny、used_amount_cny。
  • 默认情况下，limitAmount 按 USD 解释。若传 limitCurrency: "CNY"，则表示人民币限额，服务端会按当前汇率自动换算成 USD 后存储。

​
示例

curl -X PATCH "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive",
    "limitAmount": 0
  }'

​
请求 / 响应

精确 schema 和响应字段请使用上方的交互式 OpenAPI 面板。