OpenAI 修改项目托管工具权限

2026-11-17 18:23 更新

修改项目托管工具权限

post /organization/projects/{project_id}/hosted_tool_permissions

更新项目的托管工具权限。

路径参数

  • project_id: string

项目 ID。

请求体参数

内容类型:application/json

  • code_interpreter: optional object { enabled } or null

代码解释器权限的更新设置。

  • enabled: boolean

是否为项目启用该托管工具。

  • file_search: optional object { enabled } or null

文件搜索权限的更新设置。

  • enabled: boolean

是否为项目启用该托管工具。

  • image_generation: optional object { enabled } or null

图像生成权限的更新设置。

  • enabled: boolean

是否为项目启用该托管工具。

  • mcp: optional object { enabled } or null

MCP 权限的更新设置。

  • enabled: boolean

是否为项目启用该托管工具。

  • web_search: optional object { enabled } or null

网页搜索权限的更新设置。

  • enabled: boolean

是否为项目启用该托管工具。

返回值

  • ProjectHostedToolPermissions object { code_interpreter, file_search, image_generation, 2 more }

表示项目的托管工具权限。

  • code_interpreter: object { enabled }

项目中单个托管工具的权限状态。

  • enabled: boolean

是否为项目启用了该托管工具。

  • file_search: object { enabled }

项目中单个托管工具的权限状态。

  • enabled: boolean

是否为项目启用了该托管工具。

  • image_generation: object { enabled }

项目中单个托管工具的权限状态。

  • enabled: boolean

是否为项目启用了该托管工具。

  • mcp: object { enabled }

项目中单个托管工具的权限状态。

  • enabled: boolean

是否为项目启用了该托管工具。

  • web_search: object { enabled }

项目中单个托管工具的权限状态。

  • enabled: boolean

是否为项目启用了该托管工具。

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/hosted_tool_permissions" \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{}'

200 — 示例

{
  "code_interpreter": {
    "enabled": true
  },
  "file_search": {
    "enabled": true
  },
  "image_generation": {
    "enabled": true
  },
  "mcp": {
    "enabled": true
  },
  "web_search": {
    "enabled": true
  }
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/organization/projects/proj_abc/hosted_tool_permissions" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "file_search": {
          "enabled": true
      },
      "image_generation": {
          "enabled": false
      }
  }'

响应示例

{
    "file_search": {
        "enabled": true
    },
    "web_search": {
        "enabled": true
    },
    "image_generation": {
        "enabled": false
    },
    "mcp": {
        "enabled": true
    },
    "code_interpreter": {
        "enabled": true
    }
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号