11月19日模型硬停服:Azure o1/o3与Vertex迁移教程
2026年11月19日 Azure OpenAI 关停 o1/o3/o4-mini,Vertex AI 下线 gemini-3.6-flash。本文提供自动化巡检脚本、GPT-5.6 工具调用报错修复及 Gemini 3.8 迁移代码。
目录 · 10 节
- 11 月 19 日硬停服迁移指南:Azure o1/o3 与 Vertex gemini-3.6-flash 避坑
- 一、今日(11 月 19 日)停服清单与替换映射
- 二、第一步:一键扫描代码库与云端部署状态
- 三、Azure OpenAI 迁移实战:CLI 重建与 Python 代码改造
- 1. 创建替换部署(Global Standard 示例)
- 2. Python 调用迁移(核心避坑:Chat Completions 工具调用报错)
- 四、Vertex AI gemini-3.6-flash 迁往 gemini-3.8-flash 避坑
- 五、常见报错与排查清单(Troubleshooting)
- 常见问题(FAQ)
- 参考来源
11 月 19 日硬停服迁移指南:Azure o1/o3 与 Vertex gemini-3.6-flash 避坑
2026 年 11 月 19 日是本月企业级 AI 应用最危险的“硬关停”节点之一。根据 Microsoft Foundry 官方下线日历(转引自 Developers Digest) 与 Google Cloud Vertex AI 生命周期文档,今日起两朵公有云将同步执行模型永久关停:
- Azure OpenAI / Microsoft Foundry:永久下线
o1、o1-pro、o3、o3-pro、o3-deep-research、o3-mini、o4-mini共 7 款 o 系列推理模型。 - Google Cloud Vertex AI(Gemini Enterprise Agent Platform):永久下线
gemini-3.6-flash。
更棘手的是,“不报错”不代表“没出事”——Azure 的自动升级会把旧部署悄悄切到 gpt-5.6-sol 或 gpt-5.6-terra,直接导致原本正常的 Chat Completions 工具调用开始报错或账单暴涨。本文直接给出今日排查、代码修复与平滑迁移的完整实操方案。
一、今日(11 月 19 日)停服清单与替换映射
基于 EvalShift 2026 模型下线日历 与 Developers Digest 迁移对照表,今日生效的精确映射如下(以官方最新公布为准):
| 云平台 | 今日停服模型 ID | 官方指定替换模型 | 未迁移后果 |
|---|---|---|---|
| Azure OpenAI / Foundry | o1、o1-pro、o3、o3-pro、o3-deep-research |
gpt-5.6-sol |
Standard 自动升级;Provisioned 或 NoAutoUpgrade 返回 410 Gone |
| Azure OpenAI / Foundry | o3-mini、o4-mini |
gpt-5.6-terra |
同上(注意:o4-mini 微调版延至 2027 年) |
| Vertex AI | gemini-3.6-flash |
gemini-3.8-flash |
请求直接失败 |
⚠️ 注意跨平台时间差:OpenAI 第一方 API 上的
o3/o3-pro直到 12 月 11 日 才关停,而o1/o3-mini/o4-mini已于 10 月 23 日在第一方关停。如果你的业务同时跑在第一方与 Azure 上,务必以当前实际调用的平台日历为准。关于 12 月 1 日即将生效的 Gemini 2.5 自动路由,可参考 [内链:Gemini 2.5 自动路由与价格变更预警]。
二、第一步:一键扫描代码库与云端部署状态
在改代码前,先用下面这条正则命令扫出代码库里所有硬编码的临期模型 ID(含评测脚本和微调配置):
grep -rhoE "\b(gpt-[a-z0-9][a-z0-9.-]*|o[134](-[a-z0-9-]+)?|claude-[a-z0-9.-]+|gemini-[a-z0-9.-]+|codex-mini[a-z-]*)\b" \
--exclude-dir={node_modules,.git,.venv,dist} . | sort | uniq -c | sort -rn
如果你使用 Azure CLI,立即检查所有资源组的部署版本与 versionUpgradeOption:
az cognitiveservices account deployment list \
-n YOUR_RESOURCE_NAME \
-g YOUR_RESOURCE_GROUP \
--output table
在自动化 CI 检查中调用 Azure Models API 时需特别注意一个官方命名陷阱 Developers Digest:
- 文档里的 Deprecated(已弃用但仍可用),在 API 返回的
lifecycleStatus字段中叫"Deprecating"; - API 返回的
"Deprecated",实际上意味着已经彻底停服(Retired)。
三、Azure OpenAI 迁移实战:CLI 重建与 Python 代码改造
1. 创建替换部署(Global Standard 示例)
az cognitiveservices account deployment create \
-g YOUR_RESOURCE_GROUP \
-n YOUR_RESOURCE_NAME \
--deployment-name gpt-5-6-sol \
--model-name gpt-5.6-sol \
--model-version "2026-07-09" \
--model-format OpenAI \
--sku-capacity 10 \
--sku-name "GlobalStandard"
注:若遇区域拒绝 "2026-07-09" 版本号,请先查询 GET .../models?api-version=2024-10-01 确认该区域是否标记为 "2026-06-25"。如果是预配吞吐量(Provisioned/PTU)部署,Azure 不会自动升级,必须提前申请目标模型配额后通过 PUT 接口执行原地迁移(耗时约 20–30 分钟)或新建并行部署。
2. Python 调用迁移(核心避坑:Chat Completions 工具调用报错)
Microsoft 推理模型文档明确警告:gpt-5.6 系列无法在 Chat Completions 接口中同时使用推理(Reasoning)与工具调用(Tools),因为其默认 reasoning_effort 为 medium。一旦你的旧 o1/o3 部署在今日被自动升级为 gpt-5.6-sol,所有带 tools 参数的 Chat Completions 请求会直接报错。
推荐修复方案:迁移至 Azure OpenAI Responses API(v1/ 端点):
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
base_url="https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",
)
# 原 o1-pro / o3-pro 用户可通过 reasoning={"effort": "high"} 或 pro 模式等效替代
response = client.responses.create(
model="gpt-5-6-sol", # 对应你的 Azure Deployment Name
input="请检查这段 SQL 是否存在注入风险",
tools=[{"type": "web_search_preview"}],
# 防止多轮对话默认 all_turns 导致推理 Token 暴增,按需限制为当前轮次
reasoning={"context": "current_turn"},
)
print(response.output_text)
如果短期内无法将代码从 client.chat.completions.create 切走,临时止血方案是在每次带 tools 的请求中显式传入 reasoning_effort="none"。
四、Vertex AI gemini-3.6-flash 迁往 gemini-3.8-flash 避坑
在 Google Cloud 上,从 gemini-3.6-flash 切到 gemini-3.8-flash 绝不只是改一个字符串,Google AI Studio 迁移指南与 EvalShift 汇总 指出以下三个破坏性变更:
- 移除采样参数:
temperature、top_p、top_k在 3.8 系列中已被弃用或忽略; thinking_level替代thinking_budget:思考深度需改用枚举值;thought_signature校验:多轮函数调用场景下,SDK 必须回传模型生成的思考签名,否则请求会被校验拦截。
五、常见报错与排查清单(Troubleshooting)
-
报错
410 Gone(Azure OpenAI)- 原因:部署设置了
NoAutoUpgrade,或使用的是 Provisioned(PTU)部署,今日到达停服时间后直接失效。 - 解决:立即通过
az cognitiveservices account deployment create新建gpt-5.6-sol/terra部署并切换流量;PTU 需先在配额页申请新模型容量再执行PUT切换。
- 原因:部署设置了
-
报错
400 Bad Request:提示不支持同时使用reasoning与tools(Azure Chat Completions)- 原因:Standard 部署今日自动升级到了
gpt-5.6-sol/terra,而旧代码仍在用chat.completions.create传tools。 - 解决:优先改写为
client.responses.create;若需紧急恢复线上服务,在请求体中强制加reasoning_effort="none"。
- 原因:Standard 部署今日自动升级到了
-
迁移后账单突然翻倍(
o3/o4-mini升级用户)- 原因:
gpt-5.6-sol输入/输出单价($4/$20)是o3($2/$8)的 2–2.5 倍,且gpt-5.6默认开启reasoning.context = "all_turns",多轮对话会重复计费历史推理上下文。 - 解决:在 Responses API 中显式设置
reasoning={"context": "current_turn"};对延迟不敏感的异步任务切往 Azure Flex 档(半价$2/$10);或评估非官方指定但更便宜的gpt-5.6-luna($0.20/$1.20)。
- 原因:
-
CI 巡检怎么提前 60 天拦截下次停服?
- 紧盯接下来两个高危日期:11 月 30 日(Anthropic
claude-sonnet-4-5-20250929与 OpenAI 托管 Evals 停服)和 12 月 1 日(Gemini API2.5-pro/flash静默路由至3.8-flash/3.5-flash-lite)[内链:AI 模型下线自动化 CI 巡检方案]。
- 紧盯接下来两个高危日期:11 月 30 日(Anthropic
常见问题(FAQ)
Q1:Azure OpenAI 上的 o1 和 o3 停服后能申请延期吗?
不能。Microsoft Foundry 生命周期政策明确规定所有模型的退役日期均不可申请豁免或延期。
Q2:Standard 部署自动升级后,我的配额(Quota)需要重新申请吗?
不需要。对于 Standard、Global Standard 与 Data Zone Standard 的自动升级,原有 TPM 配额会自动结转至目标模型;但手动新建并行部署或迁移 PTU 时仍需检查可用配额。
Q3:o4-mini 的微调(Fine-tuned)模型今天也会停服吗?
不会。微调版 o4-mini 部署享有独立生命周期,预计延续至 2027 年 10 月或 11 月(具体以微软最新对账公告为准),但微调训练能力会提前关闭。
Q4:OpenAI 第一方 API 的 o3 什么时候停服?
OpenAI 第一方 API 的 o3 与 o3-pro 停服日期为 2026 年 12 月 11 日,比 Azure 晚约三周,但 o1、o3-mini、o4-mini 已于 10 月 23 日在第一方下线。
参考来源
[Developers Digest - Azure OpenAI and Foundry Retirements in November 2026](https://www.developersdigest.tech/blog/azure-openai-foundry-retirements-november-2026)
[EvalShift - LLM Model Deprecation Schedule 2026: OpenAI, Anthropic, Google](https://www.evalshift.dev/blog/llm-model-deprecation-schedule)
[Google Cloud Documentation - Gemini 3.6 Flash Model Page](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-6-flash)
转载请注明出处:界智通 · https://www.jieagi.com/aizixun/657.html
暂无评论