API
OpenAI API 完全教程
OpenAI API 是调用 GPT-5.6、o-series、GPT Image 2、GPT-Realtime 的统一入口。本频道从注册账号、第一行代码开始，覆盖 Python 与 Node SDK 的 Responses API 实战、流式响应、函数调用、错误排查与计费规则，让你一周内从零到上线。
共 24 篇文章
本频道你会学到什么
以下是这个频道覆盖的核心主题，每篇精选文章都会围绕其中若干点展开。
- 账号与 API Key
- Python / Node 第一个调用
- Responses API
- Streaming
- Function Calling
- 错误排查与计费
openai-python 3.49.0 与 openai-node 7.55.0：Agents 函数工具 async 设置的类型补齐
2026-11-10 发布的官方 SDK 双包：python v3.49.0 与 node v7.55.0 给 beta Agents 的函数工具形状补上既有 async 设置的类型标注——python 新增 async_ 别名字段与保留字 TypedDict，node 四个 interface 加 async 可选属性；python 同批修复 Microphone 录音的 WAV 编码。
阅读全文openai-python 3.48.0 与 openai-node 7.54.0：Agent 会话事件流的混淆填充与 stream_options
2026-11-09 发布的官方 SDK 双包更新：python v3.48.0 给 agent 会话事件流加了混淆填充开关（stream_options 与 include_obfuscation，33 个事件类型新增 obfuscation 字段）；node v7.54.0 仅同步 gpt-6-rosalind 类型与 agent scheduling 保留。本文全部事实经 GitHub API 与 tag 源码当日核对。
阅读全文openai-node 7.46–7.50：五天五版，12 小时缓存与服务分层落地 SDK（2026）
openai-node 在 10 月 31 日至 11 月 3 日连发 7.46.0 到 7.50.0 五个版本，把官方 changelog 里的 12 小时 prompt caching、项目级服务分层、workload identity 等 API 侧能力落到 TypeScript 类型层。
阅读全文openai-python 3.42.0 与 openai-node 7.46/7.47 更新解读：Agent 压缩与审查设置、外部密钥管理与 SIP DTMF
openai-python v3.42.0 与 openai-node v7.46.0/v7.47.0（2026-10-31）：Agents 会话新增后台压缩开关、auto_review 动作审查与 spend_control 支出上限，实验性 time_awareness 时间感知，组织级 external_keys 密钥管理面，Live sideband 的 SIP DTMF 发送命令，WebSocket 暖场与逐发送方投递回执，图像编辑 markup 蒙层。
阅读全文openai-python 3.40/3.41 与 openai-node 7.45.1 更新解读：缓存断点 TTL 语义、响应级工具用量与 Realtime item 引用
openai-python v3.40.0/v3.41.0 与 openai-node v7.45.1（2026-10-27/28）：缓存断点省略 ttl 时才继承请求级 TTL、Response 新增 tool_usage 托管工具用量、Realtime 支持 item_reference 引用既有会话项、agents sessions 列表按 metadata 过滤、WS 重连队列保留二进制帧、/v1/audio/translations 端点 SDK 层标弃用。
阅读全文Decisions API 正式 GA：比 Responses API 快约 10 倍的低成本判定接口解读
2026-10-22 官方公告宣布 Decisions API GA：POST /v1/decisions、gpt-6-luna 专属、未缓存输入 $0.10/1M tokens 且输出不计费、单请求最高 400 问。beta 期首次 SDK 落地是 2026-10-06。
阅读全文OpenAI SDK 一日四版：safety_identifier 进入图像接口，Realtime Translation 会话落地（v3.33/v3.34 + v7.36/v7.37）
2026-10-17 当天，openai-python 连发 v3.33.0 与 v3.34.0，openai-node 连发 v7.36.0 与 v7.37.0：safety_identifier 参数进入图像请求与响应两侧，Realtime Translation WebSocket 会话上线，两包同步新增 degraded external storage 状态，node 侧并为 GPT-4 模型别名加了 shutdown 通告。
阅读全文openai-python 3.32.0 与 openai-node 7.35.0 更新解读：prompt 建声、Live 音频夹具与 Live Decisions
2026-10-16 两包官方 SDK 同日再发：语音可以用一段文字描述直接创建（但只在 Live 可用）、Live 会话能播 30 秒内的音频夹具、Decisions 问题评估接进 Live 转写触发器，Decisions API 也拿到了 prompt caching。本文只写两包 CHANGELOG 与 tag 源码里能指出的东西。
阅读全文OpenAI SDK 新增 Browser/Computer 工具集（1/4）：BrowserToolset 把驱动方法变成 Responses 函数工具
2026-10-14 两包官方 SDK 同日四发：openai-python 3.30.0/3.31.0 与 openai-node 7.33.0/7.34.0。头条是标注 (1/4) 的 browser and computer toolsets——BrowserToolset 不给 Responses API 加原生浏览器工具类型，而是把你自带驱动的结构化方法变成普通函数工具。本文只写两包 CHANGELOG 与 v3.31.0 tag 源码/文档里能指出的东西。
阅读全文OpenAI SDK 出现托管 Agent 环境资源：prewarmed 预热创建、闲置挂起与过期事件
2026-10-09 至 10-11 三天,openai-python 连发 v3.27.0/v3.28.0/v3.29.0、openai-node 发 v7.32.0,同一条 agent environment API 线浮出水面:预热创建、挂起与过期。本文只写 SDK 源码与当日 GitHub release notes 里能指出的东西。
阅读全文OpenAI API 429 限流错误排查：RateLimitError 与 SDK 重试机制
遇到 OpenAI API 429 时先分清两类：请求速率超限还是配额耗尽——两者都抛 RateLimitError 但解法完全不同。官方 Python SDK 默认已替你重试 2 次并遵守 Retry-After，本文按 SDK 源码把机制与排查路径讲清。
阅读全文openai-node v7.20.0 更新解读：环境变量 vault 凭据、外部存储管理与 safety cases 检索
openai-node v7.20.0 一版带六个 PR：vault 凭据新增 environment_variable 类型（沙箱只拿占位符、出站代理 443/8443 替换密钥）、admin 外部存储配置管理面、safety cases 检索端点与 warning/deactivation 两个新 webhook 事件、三个来电事件的 SIP 媒体安全字段，外加遗留 GET 请求选项修复。逐项对应 PR 与 tag 源码拆解。
阅读全文