gpt-6-astra 现身 OpenAI SDK：ChatModel 枚举新模型 ID 与 Safety Alerts API 解读

2026-09-03，OpenAI 两个官方 SDK 同一天发了一个功能版本：openai-python v3.8.0 与 openai-node v7.10.0（均为当日 19:50 UTC 发布），release notes 的标题都写着同一句话——"add gpt-6-astra and related features"。这个版本把一个此前从未在类型层出现过的新模型 ID 写进了两包的 ChatModel 枚举，并随之落地了一整套此前不存在的能力面：Safety Alerts API、misalignment 错误详情、两个新的 webhook 事件。

本文的写法先说清楚：我们只陈述能在 SDK 源码里逐字指出的东西。所有引用都来自 2026-09-10 当日重抓的 GitHub release notes、PR diff 与 tag 源码（清单见文末 officialReferences）；OpenAI 官方文档域当日对本站 403，涉及官方公告侧的状态一律日期锚定、不做超出核验的断言。

更新（2026-09-15）：本文的"未发布"边界已被后续事实推进——GPT-6-Astra 已随 Codex CLI 0.154.0（2026-09-09）进入模型选择器（排位第一）与 Amazon Bedrock 目录，随附的官方迁移指南确认 Responses API 以 model: gpt-6-astra 调用；本文对类型层事实的拆解仍然成立。最新状态与迁移清单见《GPT-6-Astra 落地：进入 Codex 模型选择器与 Amazon Bedrock 目录》。

1. 概述：能确认什么，不能确认什么

gpt-6-astra 是 2026-09-03 起 OpenAI 官方 SDK 类型层出现的新模型 ID：openai-python v3.8.0 与 openai-node v7.10.0 把它写进 ChatModel 类型枚举并排在 GPT-5.6 三档之前，文档示例同步替换。截至 2026-09-10 核对，官方未在可公开加载的渠道公布其发布状态、定价与能力。

把边界画清楚，一张表就够：

对"❓"的三行，本文统一不推断。这不是保守，是这类情报文唯一的正确姿势：SDK 类型是自动生成的（两包源码头注释都写着 generated from our OpenAPI spec），它证明"spec 里有"，不证明"已对外提供服务"。

2. 类型枚举里的 gpt-6-astra：三条可复现事实

2.1 ChatModel 枚举新增，排在 GPT-5.6 三档之前

Python 侧 src/openai/types/shared/chat_model.py（v3.8.0 tag）：

ChatModel: TypeAlias = Literal[
    "gpt-6-astra",
    "gpt-5.6-sol",
    "gpt-5.6-terra",
    "gpt-5.6-luna",
    ...
]

Node 侧 src/resources/shared.ts（v7.10.0 tag）：

export type ChatModel =
  | 'gpt-6-astra'
  | 'gpt-5.6-sol'
  | 'gpt-5.6-terra'
  | 'gpt-5.6-luna'

两包的枚举顺序一致：gpt-6-astra 排在 gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna 之前。排序本身是可复现的事实；至于排序为什么这么排，源码不解释，我们也不解释。

2.2 文档示例全站替换

PR #3791（Python）/ #2582（Node）的 diff 里，含 gpt-6-astra 的行分别有 326 行 / 241 行（2026-09-10 grep 计数）——全部集中在文档示例：示例请求的 model 参数、示例响应对象的 model 字段、流式 chunk 示例、微调任务示例。替换前的示例模型名是 gpt-5.6-sol。也就是说，OpenAI 把官方 API 文档里的"示例模特"换成了一个尚未官宣的 ID——这是比枚举新增更强的信号，但仍然是 spec 层信号，不是发布公告。

2.3 没有 snapshot、没有别名、没有定价字段

枚举里只有裸的 gpt-6-astra，没有 gpt-6-astra-YYYY-MM-DD 形态的快照变体，SDK 的模型类型里也没有任何定价或定位描述（GPT Image 2.5 落地时好歹还有 quality 档位调整可看）。能从类型层读出的信息就这么多。

3. 同批落地的 Safety Alerts API

"related features" 里最大的一块是一个此前完全不存在的能力面：Safety Alerts。它把"一次请求触发了安全拦截"变成了可查询的对象。

3.1 端点与对象

• 端点：GET /v1/safety/alerts/{id}，规范摘要 "Retrieve a safety alert"，描述原文 "Get a safety alert belonging to the authenticated API project."
• SDK 方法：client.safety.alerts.retrieve(id) -> SafetyAlert
• 返回对象 safety.alert 的字段（src/openai/types/safety/safety_alert.py，v3.8.0 tag）：

error_type 的 4 个枚举值：

• potentially_unintended_data_transfer（潜在的非预期数据传输）
• potentially_unintended_data_access（潜在的非预期数据访问）
• potentially_unintended_destructive_activity（潜在的非预期破坏性活动）
• other

规范在错误详情侧另有一句值得划线的话："An optional classification; clients must accept additional values"——客户端必须能兜住未来新增的枚举值，做穷举 switch 的记得留 default 分支。

3.2 两个 webhook 事件

同批新增两个 webhook：

• safety.alert.created："Sent when an approved safety alert is available for an API project."（project 维度）
• safety.org_alert.created："Sent when an approved safety alert is available for an enterprise workspace."（enterprise workspace 维度）

也就是说，警报不只可以拉取，还可以在审批通过后主动推送给你——把安全事件接进现有的事件驱动架构成为可能。

3.3 request_paused 的注释，值得单独一节

SDK 给 request_paused 写的 docstring 原文是：

Whether block registration succeeded for this request. This does not confirm that response execution stopped.

翻译过来：这个字段只告诉你"拦截登记成功"，不确认响应执行真的停了。官方在自己生成的类型文档里主动划出断言边界，这在 OpenAI 的 SDK 文档里并不常见——做安全审计、告警、自动熔断的团队，请把这句话当成实现语义对待，不要把 request_paused == true 直接当成"那次请求被成功拦下"的证明。

4. misalignment 错误详情与 steer 指令

同一批 PR 给 ErrorObject 增加了可选的 misalignment 字段，把"模型行为偏离预期"错误结构化了：

class Misalignment(BaseModel):
    detailed_explanation: Optional[str] = None   # The public explanation for this block.
    error_type: ...                              # 与 safety alert 同一套 4 值分类
    steer: Optional[MisalignmentSteer] = None    # An optional public continuation instruction.

class MisalignmentSteer(BaseModel):
    message: str                                 # The public continuation instruction.

三个组成部分：公开解释（为什么拦截）、分类（4 值，可扩展）、steer 续写指令（一段可以公开使用的 message，供客户端在被拦截后引导对话继续）。API 规范同步出现了新错误码 misalignment_policy_violation。这套结构意味着：安全拦截不再只是一个错误字符串，客户端可以程序化地区分拦截原因，甚至拿到官方给出的"下一步怎么问"。

5. 其余相关 features

同一批 PR 里还有几处值得一提的规范变更：

• context_management 类型重命名：ContextManagement 更名为 ResponseCreateContextManagement，旧名以向后兼容导出保留。字段语义不变：type 目前仅支持 compaction，另有触发压缩的 token 阈值字段。
• beta responses 支持推理深度热更新：response configuration update 新增 reasoning 字段，规范原文 "Updates to reasoning configuration. Only effort is supported"——后续响应的 reasoning.effort 可以在会话中途更新，直到下一次更新。
• 新增错误码 invalid_subject_token：身份凭据类校验失败有了独立的错误码。

6. 不能确认的部分，以及如何自行核实

再次明确本文不做断言的三件事：gpt-6-astra 是否已发布可调用、定价与窗口、与 GPT-5.6 的关系。截至 2026-09-10 核对，OpenAI 官方文档域（developers.openai.com / platform.openai.com / help.openai.com / openai.com）对本站均返回 403，本站无法核对官方 changelog 与定价页侧的状态；SDK 类型层没有这些信息，我们不从命名做推断。

更新（2026-09-15）：上述三项中"是否已发布可调用"与"与 GPT-5.6 的关系"已随 Codex CLI 0.154.0 捆绑的官方迁移指南有了答案——Responses API 可用、角色映射为 Sol→Astra 且 Terra/Luna 保留（见文首更新注记）；定价数字截至当日仍未见于可加载渠道。

想自己复现本文事实，两条命令就够（任一能访问 GitHub raw 的环境）：

# 事实 1：ChatModel 枚举首行是 gpt-6-astra
curl -s https://raw.githubusercontent.com/openai/openai-python/v3.8.0/src/openai/types/shared/chat_model.py | head -12

# 事实 2：SafetyAlert 类型的完整字段与注释
curl -s https://raw.githubusercontent.com/openai/openai-python/v3.8.0/src/openai/types/safety/safety_alert.py

后续跟踪建议盯三类信号（按可信度排序）：官方 changelog / 定价页出现该 ID、SDK 里出现快照变体或定价相关字段、ChatModel 枚举的后续增删。任一发生，本站会在模型更新日志里跟进。

7. 常见错误与排查

• 把枚举新增当成发布公告：ChatModel 里有 ID ≠ 模型已发布。自动生成的 spec 历来包含未开放的能力面，判断"能用"永远以官方 changelog / 定价页为准。
• 在生产代码里硬编码 gpt-6-astra：未经官方公告确认的 ID，随时可能从枚举里消失或实际不可调用。要实验，放 feature flag 后面并处理 model_not_found 类错误。
• 对 error_type 做穷举 switch 不留 default：规范原文明确 "clients must accept additional values"，新增枚举值时你的代码不能崩。
• 把 request_paused 当拦截成功证明：SDK 原文注释已说明它不确认响应执行停止，见 3.3。
• 升级后 ContextManagement 导入报错：v3.8.0 起类型更名为 ResponseCreateContextManagement；旧名暂时向后兼容，但新代码用新名。

8. 下一步

• 《GPT-6-Astra 落地：进入 Codex 模型选择器与 Amazon Bedrock 目录》：2026-09-15 的后续——选择器、Bedrock 目录与官方迁移指南的完整拆解。
• 《OpenAI API key 过期策略详解：expires_in_seconds、组织级 policy 与自动化密钥治理》：同周内另一批 SDK 类型层变化（v3.11.0 / v7.13.0）的完整拆解。
• 《openai-python 3.9 / 3.10 与 openai-node 7.11 / 7.12 更新解读：prompt cache 诊断、API key 过期与 GPT Image 2.5》：紧随其后的四个 SDK 版本更新解读。
• 《OpenAI 模型更新日志（2026 持续更新）》：GPT-5.6 家族与全模型发布时间线，gpt-6-astra 的官宣（若发生）会在这里跟进。
• 《GPT 模型完全指南（2026-07）：GPT-5.6 Sol / Terra / Luna 选型》：当前已发布旗舰家族的选型指南。