设置 API 密钥限制

密钥限制可让一把 API 密钥只在预定范围内使用。限制不是必须设置，但对于生产程序、多人协作或不完全可信的设备非常有帮助。

常见设置

1. 在“API Keys”列表中找到目标密钥。
2. 点击编辑操作，打开密钥设置。
3. 按需要填写名称、额度、模型、分组、过期时间或 IP 限制。
4. 保存后，用目标程序重新发起一次请求确认设置符合预期。

修改限制后的影响

• 降低额度后，已经运行的程序在达到新上限时会被拒绝。
• 删除某个模型后，使用该模型的客户端会收到模型不可用或权限错误。
• 设置过期时间后，到期不一定会提前提醒，请在程序中准备更换密钥的计划。
• IP 限制只适合固定出口地址；家庭网络、移动网络或代理网络的 IP 可能变化。

字段解释

字段	含义和用途
状态	启用时可以调用；禁用后平台拒绝使用这把密钥的新请求。
额度限制	该密钥可使用的最大 Quota。达到上限后请求会失败，但账户其他密钥不一定受影响。
模型限制	允许调用的模型名单。未列入的模型会被拒绝。
分组	平台对模型和计费规则的分类。只能选择账户可用的分组。
过期时间	到达指定时间后密钥自动不可用，适合临时测试。
IP 限制	仅允许指定网络出口 IP 使用密钥，适合固定服务器。

关键概念

关键词	含义和用途
Quota	平台用来计算余额和消费的内部额度单位。
IP 地址	网络设备的地址。IP 限制填错会导致自己的程序也无法调用。
模型	AI 服务的具体能力名称，例如文本对话或图像生成模型。
分组	把可用模型和规则归类的标签；不是普通的聊天分组。

提示

首次设置 IP、模型或额度限制时，建议先使用一把测试密钥验证，避免影响正在运行的生产程序。

推荐的最小权限原则

只给程序完成任务所需要的权限。例如，一个只负责文本问答的程序不必开放图像模型；一个临时测试程序不必拥有很高的额度上限。限制越具体，密钥泄露后的潜在损失越小。