OpenAI Code Interpreter 怎么用？容器、文件、网络与成本

Code Interpreter 适合什么任务？

Code Interpreter 是 OpenAI 托管的 Python 工具。模型可以在隔离容器中反复编写和执行代码，用于数据清洗、统计计算、表格分析、图表生成、文档处理、图片变换和可复现的数学推导。它适合“让模型通过代码得到结果”，不适合直接代替业务数据库权限、付款、发信或不可逆系统操作。

最小 Responses API 示例

官方文档把 Code Interpreter 称为模型看到的“Python tool”。下面示例遵循 2026-11-01 的官方请求形状；模型名称、可用工具和价格可能调整，上线前仍需重新检查。

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  tools: [{
    type: "code_interpreter",
    container: {
      type: "auto",
      memory_limit: "1g"
    }
  }],
  input: "使用 Python 工具读取数据、计算汇总并生成 CSV。"
});

console.log(response.output_text);

tool_choice: "auto" 允许模型自行判断是否需要执行代码；任务必须执行 Python 时才考虑 "required"。不要只根据自然语言猜测工具是否运行，应读取 Response 输出中的 code_interpreter_call 项和生成文件注释。

auto 容器和显式容器怎么选？

方式一：auto，适合一次性或上下文内复用

在工具定义里使用 {type:"auto"}，可同时传入 file_ids 和 memory_limit。系统会创建容器，或在模型上下文里存在有效 code_interpreter_call 时复用活动容器。响应中的调用项会提供实际 container_id。

{
  "type": "code_interpreter",
  "container": {
    "type": "auto",
    "memory_limit": "4g",
    "file_ids": ["file_abc", "file_xyz"]
  }
}

方式二：先创建容器，适合显式生命周期管理

先调用 POST /v1/containers 创建容器，再把返回的 ID 作为工具的 container。这样便于在请求前添加文件、设置网络策略、检查文件列表，或让多个明确的请求使用同一个容器。

curl https://api.openai.com/v1/containers \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "sales-analysis",
    "memory_limit": "4g",
    "network_policy": {"type": "disabled"}
  }'

内存、过期与复用边界

官方当前提供 1g、4g、16g 和 64g 内存档位，默认是 1 GB。内存选择在容器整个生命周期内有效；不要为了“可能更快”直接选最大档，应按真实文件、峰值内存、执行时间和成功率做基线。

• 容器连续 20 分钟未使用会过期，之后用它创建 Response 会失败。
• 过期容器不能重新激活；创建新容器并重新上传输入。
• 获取容器、添加文件或删除文件会刷新 last_active_at。
• 自动创建的容器也能通过 /v1/containers 接口查看和管理。

怎样上传输入并下载生成文件？

可以把 Files API 的 file_id 放入 auto 容器配置，也可以通过 Create container file 把文件加入显式容器。模型输入中的文件会自动复制进容器，但 Files API 的上传与保留限制、Responses 输入限制和容器可处理格式仍是不同边界。

当模型生成 CSV、PNG 等文件时，助手消息会返回 container_file_citation 注释，其中包含 container_id、file_id 与文件名。应用应把这些注释渲染为下载入口，并通过 Retrieve container file content 获取实际字节。

for (const item of response.output ?? []) {
  if (item.type !== "message") continue;
  for (const part of item.content ?? []) {
    for (const annotation of part.annotations ?? []) {
      if (annotation.type === "container_file_citation") {
        console.log(annotation.container_id,
                    annotation.file_id,
                    annotation.filename);
      }
    }
  }
}

Code Interpreter 可以联网吗？

显式容器的默认 network_policy 为 disabled，即禁用出站网络。如果确实需要访问外部数据，应使用 allowlist 只开放必要域名；不要给任意互联网访问权限，也不要让模型自己决定新增域名。

{
  "network_policy": {
    "type": "allowlist",
    "allowed_domains": ["api.example.com"],
    "domain_secrets": [{
      "domain": "api.example.com",
      "name": "EXAMPLE_TOKEN",
      "value": "由服务端密钥系统注入"
    }]
  }
}

domain_secrets 只应绑定到允许域名。日志、代码、Prompt、下载文件和错误信息都不应输出密钥值。对外部响应仍要做 Schema 校验、大小限制、超时、内容安全和提示注入隔离。

费用怎么计算？

截至 2026-11-01，官方价格页为 Hosted Shell 与 Code Interpreter 容器列出以下 20 分钟价格；页面同时说明符合条件的容器会按分钟计费，每次会话最低 5 分钟。模型输入输出 Token 另按所选模型费率计算。

真实单位成本还应包含模型 Token、失败重试、文件存储与传输、下游服务、人工复核和容器空闲。按“成功任务”记录容器档位、使用分钟数、Token、运行次数、生成文件数、错误率和总费用，参见 OpenAI API Usage 与成本。

生产安全清单

• API Key 只放在受信任后端，不写进浏览器、Prompt、代码片段或容器输出。
• 默认禁用网络；需要联网时使用最小域名白名单和域名级密钥。
• 把用户文件视为不可信输入，限制类型、大小、压缩包、宏、序列化文件和解析时间。
• 不要执行用户提供的任意安装命令或从未知 URL 下载代码。
• 限制单任务内存、调用轮数、执行时长、输出大小和总预算。
• 生成文件下载后做病毒扫描、MIME 校验和访问控制，再提供给最终用户。
• 记录 request ID、response ID、container ID、代码调用、文件 ID、耗时和费用，但不要记录秘密值或完整敏感数据。

常见故障怎么排查？

常见问题

本文核对日期为 2026-11-01。容器能力、支持模型、文件格式、内存、网络策略、过期规则与价格可能调整；生产发布前请重新读取 Code Interpreter、Containers API、Responses API 与 Pricing 官方文档。