概览
该接口会在当前管理令牌所属的组织下创建一个新的type=user API Key。
请求体
| 字段 | 类型 | 默认值 / 限制 | 说明 |
|---|---|---|---|
name | string | 必填,默认 Default Key,长度 1-50 | 展示名称,服务端会先 trim |
limitAmount | number | null | 最小 0,最大 100000 | null 或省略 = 不限额,0 = 零额度,正数 = 美元上限 |
limitCurrency | enum | 默认 USD | 可选:USD 或 CNY。当设置为 CNY 时,limitAmount 会按人民币理解,并在服务端按当前汇率换算成 USD 后存储 |
models | string[] | 默认 [] | 可选的逻辑模型白名单 |
expiresAt | string | null | RFC3339 datetime | null 表示永不过期 |
说明
- 响应中的完整 API Key 只会返回一次。
models: []表示该 Key 除组织级策略外没有额外模型限制。limitAmount: 0会创建一个合法但无法消费额度的 Key,后续可再更新。- 响应会额外返回
exchange_rate,以及人民币展示字段limit_amount_cny、used_amount_cny。 - 默认情况下,
limitAmount按 USD 解释。若传limitCurrency: "CNY",则表示人民币限额,服务端会按当前汇率自动换算成 USD 后存储。