可信 IP

某个 API 密钥从未经批准的 IP 地址发起调用时，先拦下，等有人批准这个地址再放行。密钥泄露后被别人从新地址使用，拿到的只会是拒绝，而不是模型的回答。

控制台侧边栏位置(该功能适用于你的账户时才会出现): Settings › Security 打开 ↗

操作步骤

1. 打开系统设置 › 安全，开启新 IP 需审批。弹窗会列出每个密钥过去 7 天用过的地址，其中公网地址默认勾选；取消勾选你不认识的地址，再确认开启。只有工作区所有者和管理员能修改这项设置；如果网关看不到真实的客户端地址（所有调用都像是从代理后面的内网地址发来的），这项设置无法开启。
2. 开启后，来自其他地址的调用会被拒绝，返回 403，错误码为 ip_not_trusted。错误信息里写明网关看到的地址，并附上批准页面的链接（字段 ip 和 approve_url）。密钥的创建者会收到邮件，写明地址、所在位置、客户端和请求的模型（管理密钥写的是调用的操作）；属于工作区的管理密钥，或创建者已离开工作区的密钥，邮件发给所有者和管理员。
3. 打开链接并登录，批准这个地址；如果客户端的出口地址会变，也可以批准它所在的网段（IPv4 为 /24，IPv6 为 /64）；也可以拒绝。批准后，这个地址的下一次调用即可通过。
4. 可信 IP 列表展示你的密钥调用过的地址，以及各自的位置和状态。已知的地址点一下即可信任；也可以用添加 IP 手动添加地址或网段（IPv4 最宽 /16，IPv6 最宽 /32），或者移除已信任的地址。

限制与注意事项

• 信任按密钥生效：批准一个地址，只让这个密钥能从该地址调用，不会放行工作区里的其他密钥。推理密钥和管理密钥都适用。
• 自带 IP 白名单的密钥，只要名单里没有比 /16（IPv4）或 /32（IPv6）更宽的网段，就不受影响，只由它自己的白名单决定。名单里有更宽网段（比如 0.0.0.0/0）的密钥，和其他密钥一样需要审批。关闭新 IP 需审批后，所有地址都能再次调用，已信任的地址会保留，下次开启时仍然有效。
• 密钥的创建者、工作区所有者和管理员都可以批准（属于工作区的管理密钥只能由所有者和管理员批准）。批准要在控制台登录后进行；邮件里没有批准按钮，转发出去的邮件批准不了任何地址。
• 待批准的请求 7 天后过期。地址被拒绝后的 30 天内，来自它的调用照样被拒绝，但不会新建请求，也不会发邮件。每次运行都换出口地址的 Serverless 函数和 CI 任务，每次都会被拦下：给它们单独用一个设了 IP 白名单的密钥，或者信任它们所在的网段。