GPTMap

API

OpenAI API 完全教程

OpenAI API 是调用 GPT-5.6、o-series、GPT Image 2、GPT-Realtime 的统一入口。本频道从注册账号、第一行代码开始，覆盖 Python 与 Node SDK 的 Responses API 实战、流式响应、函数调用、错误排查与计费规则，让你一周内从零到上线。

共 14 篇文章

本频道你会学到什么

以下是这个频道覆盖的核心主题，每篇精选文章都会围绕其中若干点展开。

  1. 账号与 API Key
  2. Python / Node 第一个调用
  3. Responses API
  4. Streaming
  5. Function Calling
  6. 错误排查与计费
API
4 分钟

OpenAI API 429 限流错误排查：RateLimitError 与 SDK 重试机制

遇到 OpenAI API 429 时先分清两类：请求速率超限还是配额耗尽——两者都抛 RateLimitError 但解法完全不同。官方 Python SDK 默认已替你重试 2 次并遵守 Retry-After，本文按 SDK 源码把机制与排查路径讲清。

阅读全文
API
14 分钟

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 源码拆解。

阅读全文
API
12 分钟

openai-python 3.15 / 3.16 与 openai-node 7.18 / 7.19 更新解读：缓存预热、Webhook 管理与 connector_id 弃用

OpenAI 官方 SDK 9-18 一天六版：prompt_cache_options 新增 prewarm 缓存预热、client.webhooks 补齐 Webhook 端点管理 REST 面、MCP 工具 connector_id 标记弃用（2026-09-01 后模型）、WebSocket 会话 lane 路由库双语言落地。逐项对应 PR 拆解，附可复制示例。

阅读全文
API
12 分钟

Responses API 压缩进度事件解读：response.compaction.compacting、compaction_trigger 与长会话上下文压缩

openai-node v7.17.0 给 Responses API 流式事件族补上压缩进度事件 response.compaction.compacting：处理 compaction_trigger 时至多每 30 秒上报一次，不携带任何摘要内容。它和 compaction_trigger 输入项、/responses/compact 端点、context_management 配置如何配合，本文逐项拆解。

阅读全文
API
14 分钟

openai-python 3.14.x 与 openai-node 7.16 / 7.17 更新解读：流式错误规范化、WebSocket 背压与 SSE 兜底

OpenAI 官方 SDK 三天四版，主题罕见地统一：可靠性。python 侧流式消费的超时与断连改抛 SDK 异常、错误码统一字符串化、max_retries 请求前预校验；node 侧 WebSocket 迭代器有了 maxBufferedEvents 背压上限、SSE 末事件缺尾空行不再丢。逐项对应 commit 拆解，附可复制示例。

阅读全文
API
12 分钟

Agents API 现身 OpenAI SDK（beta）：/agents CRUD、environments、sessions 与 vaults 全景

2026-09-10 晚间的 openai-python v3.13.0 与 openai-node v7.15.0 落地了 Agents API（beta 命名空间）：可复用 Agent 的 CRUD、带执行环境的 Managed Agents session、subagents 与 turns、以及存凭据的 vaults。这是 Assistants API 关停（08-26）后两周内 SDK 里出现的最重新接口面。本文只写能在 SDK 源码里指出的东西。

阅读全文
API
9 分钟

OpenAI API key 过期策略详解：expires_in_seconds、组织级 policy 与自动化密钥治理

Service Account API key 的过期语义在 v3.11.0 / v7.13.0 里完成了关键升级：key 默认不过期的时代结束了——组织或项目级过期策略可以强制要求过期，最大生命周期内必须显式传值。参数边界、代码示例与运维清单一次讲清。

阅读全文
API
14 分钟

openai-python 3.9 / 3.10 与 openai-node 7.11 / 7.12 更新解读：prompt cache 诊断、API key 过期与 GPT Image 2.5

OpenAI 官方 SDK 两天连发四个版本，随后补两个 key 过期治理版本，09-10 晚间再追加 Live API 与 Agents API 两对版本：prompt cache 诊断、Service Account API key 过期与组织级 policy、GPT Image 2.5 模型类型，以及两个全新 API 面。逐项解读，附可复制代码。

阅读全文
API
8 分钟

Responses API vs Chat Completions：该迁移了吗

Assistants API 已关停、Chat Completions 进入 legacy。本文按状态管理、工具定义、内置能力逐项对比两代 API，并给出一务流一条的渐进迁移路径。

阅读全文
API
10 分钟

OpenAI 结构化输出完全指南：json_schema、strict 模式与常见报错

让模型稳定输出可解析 JSON 的完整路径：Responses API 的 text.format 写法、strict 模式、schema 设计要点，以及只放 schema 不放 name 这类高频报错的排查。

阅读全文
API
10 分钟

Responses API 高级实战：structured outputs / 流式 SSE / Batch / prompt caching

Responses API 进阶用法：JSON Schema 严格模式、流式 SSE 解析、Batch API 离线降本、prompt caching 三层缓存、成本优化案例。从『能调通』到『生产级』。

阅读全文
API
7 分钟

OpenAI API 错误处理与重试：401/429/5xx 实战模式

OpenAI API 在生产环境最常见的错误码（401/429/500/503/timeout）实战处理：指数退避、jitter 抖动、错误预算、上游保护、与 streaming 的特殊处理。

阅读全文
12