OpenAI API 组织访问限制

2026-11-09 15:42 更新

API 组织访问限制允许通过代理或安全访问服务边缘(SASE)服务,限定用户从你的网络可以访问哪些 API 组织。

工作原理

在网络配置中添加自定义 HTTP 请求头 OpenAI-Allowed-Organization-Ids,指定一个或多个允许访问的组织 ID,例如 org-…。多个值用逗号分隔,不加空格。

用户从该网络登录 API Platform 时,OpenAI 读取请求头并检查目标组织。组织未列入时返回 403 并阻止访问;只有列表中的组织可访问。

设置

步骤一:查找组织 ID

登录 API Platform,切换到要允许的组织,在组织设置页复制 Organization ID,例如 org-Tkxfm8owx4zIPaJGNDVrPs6m。为每个目标组织重复操作。

步骤二:配置请求头

通过代理或 SASE 配置发送该头。多个组织 ID 使用逗号、不加空格。设置 URL 匹配范围,仅对发往 https://api.openai.com/* 的请求应用此头。

步骤三:验证配置

从规则生效的网络设备测试:

  1. 用同时拥有列表内和列表外组织访问权的账户登录。
  2. 打开列表内组织,确认可访问。
  3. 打开列表外组织,确认被阻止并返回 403。
  4. 允许多个组织时,逐个确认可访问。

结果与预期不符时,检查代理/SASE 规则是否作用于测试设备,以及请求头中的组织 ID 是否正确。

排查访问错误

  • 403:访问了未允许的组织,消息说明无权访问该组织。
  • 400:请求头格式错误,例如组织 ID 无效,携带该头的全部请求都会失败。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号