AI 接口停服清单提醒迁移模型与提示词
文章称七项 AI 服务将于 11 月 30 日停止,并列出模型标识、云端部署、评测接口和托管提示词的排查线索。摘录提醒模型迁移可能涉及思考参数变化,以及提示词变量、版本的迁移校验。
AI 深度解读
如果模型突然返回错误,先别急着查业务代码,也可能是接口已经退役。原文列出了一份声称将在 11 月 30 日停用的 AI 服务清单,涉及 Claude 的三个平台入口、OpenAI 的评估与 Agent 工具,以及 Bedrock 上的向量模型。
它最有用的地方,是把迁移拆成了「搜哪里、换什么、怎么验」。但日期和替代方案需要另行核实:所给正文没有注明年份,也没有附上各厂商公告的具体链接,不能直接当作已经确认的停服通知。
换 Claude 模型,不能只改一个字符串
原文前三项都指向 Claude Sonnet,但部署位置不同,检查方式也不同。
Anthropic API 的旧模型 ID 是 claude-sonnet-4-5-20250929。作者建议搜索 sonnet-4-5、sonnet-4.5,替换为 claude-sonnet-5-5。
这里有一个参数兼容问题:作者称,使用 extended thinking 时,budget_tokens 在 Sonnet 5.5 上会返回 400,需要改为 thinking: {type: "adaptive"}。因此,模型名替换后,还要检查请求体。验证顺序是先从已部署应用发起一次真实调用,再运行评估。
Azure 上则要检查部署资源。代码可能只引用部署名称,看不到底层模型。原文给出的检查命令是 az cognitiveservices account deployment list,并建议将 claude-sonnet-4-5 替换为 claude-sonnet-5-5。
Google Vertex AI 的模型标识可能携带 @ 版本。作者建议迁移到 Vertex AI 当前可用的 Claude Sonnet,没有给出确定的替代 ID,不能直接照搬其他平台的字符串。
工具退役,要搬走的不只是调用代码
OpenAI 相关的三项,分别涉及评估、提示词和工作流,迁移对象各不相同。
对于 Evals platform,作者建议搜索 client.evals 和 /v1/evals,并称现有评估自 10 月 31 日起已经只读,应尽快导出需要保留的内容。原文将 Promptfoo 称为 OpenAI 文档提供的迁移路径,但没有展示迁移步骤或兼容范围。
对于 reusable prompts,检查范围包括 v1/prompts、prompt objects,以及代码里的 pmpt_ 和 prompt={"id":。作者建议把提示词正文放回自己的代码或配置。复制完成后,要抽取几组真实输入对比输出,因为从 dashboard 搬出的文本可能遗漏变量或版本信息。
对于 Agent Builder,作者建议改用 Agents SDK 或 ChatGPT Workspace Agents,并称 ChatKit 继续可用。这里需要重建工作流,再完整跑通主路径;仅仅确认 SDK 能连通,还不能证明原来的流程已恢复。
向量模型换版,旧数据也要处理
最后一项是 Amazon Bedrock 上的 TwelveLabs Marengo Embed 2.7,搜索标识为 marengo-embed-2-7。原文没有给出替代模型。
作者提醒,新旧模型生成的 embeddings 不能直接比较。可以把向量理解成模型给内容分配的一组坐标:换了模型,坐标的含义也可能变化。要把新旧内容放进同一套检索流程,就需要重新生成向量,不能只更新查询端。
此外,模型 ID 经常藏在环境变量、secrets、feature flags 和数据库记录里。下面这条命令适合先扫描本地文件:
grep -rnE "sonnet-4-5|sonnet-4\.5|pmpt_|marengo-embed-2-7" .
要看清匹配表达式的范围:它没有覆盖 client.evals、/v1/evals 或 Agent Builder,也查不到远端部署配置和数据库内容。
我的判断
这份清单可以用来组织排查,不能单独用来确认停服事实。
作者没有展示真实迁移记录、调用日志或迁移前后的对照数据。文中的参数报错、替代模型和平台去向,都应视为待核实的具体主张;测试建议则属于操作经验,不是效果证明。
清单还有一个容易误读的地方:「7 项」包含同一模型的不同云平台入口,也包含整个平台功能,并非 7 个独立模型。它们不能套用同一种迁移方法。
我赞同它强调部署配置、提示词版本和向量重建。相比只做全局字符串替换,这些检查更接近实际依赖。不过,原文最后推荐了 Versyka 的 model retirement calendar,却没有在所给正文中逐项展示厂商依据。日历适合提醒,具体变更仍应回到对应厂商公告确认。
能拿来做什么
- 给 Node 服务做一次依赖盘点,把代码搜索结果与环境变量、云端部署和数据库配置逐一核对,记录实际使用的模型及功能入口。
- 迁移提示词或 Agent 工作流时,保留旧版本,准备几组真实输入,分别检查变量、输出和完整业务路径。
- 如果应用使用向量检索,先确认旧数据采用的 embedding 模型,再安排重建与切换,避免新查询直接检索旧模型生成的向量。