跳转到主要内容

概览

该接口会在当前管理令牌所属的组织下创建一个新的 type=user API Key。

请求体

字段类型默认值 / 限制说明
namestring必填,默认 Default Key,长度 1-50展示名称,服务端会先 trim
limitAmountnumber | null最小 0,最大 100000null 或省略 = 不限额,0 = 零额度,正数 = 美元上限
limitCurrencyenum默认 USD可选:USDCNY。当设置为 CNY 时,limitAmount 会按人民币理解,并在服务端按当前汇率换算成 USD 后存储
modelsstring[]默认 []可选的逻辑模型白名单
expiresAtstring | nullRFC3339 datetimenull 表示永不过期

说明

  • 响应中的完整 API Key 只会返回一次。
  • models: [] 表示该 Key 除组织级策略外没有额外模型限制。
  • limitAmount: 0 会创建一个合法但无法消费额度的 Key,后续可再更新。
  • 响应会额外返回 exchange_rate,以及人民币展示字段 limit_amount_cnyused_amount_cny
  • 默认情况下,limitAmount 按 USD 解释。若传 limitCurrency: "CNY",则表示人民币限额,服务端会按当前汇率自动换算成 USD 后存储。

示例

curl -X POST "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

请求 / 响应

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