--- title: "2026年9月，第三方 API 都发生了哪些变更 | Harbyn" description: "Harbyn 追踪的 170 个厂商中，有 87 个共发布了 706 项变更：83 项破坏性变更、17 次模型退役、厂商给出的提前通知时长，以及 1 月初之前到期的 71 个截止日期。" canonical: "https://harbyn.com/cn/blog/api-changes-september-2026" last-updated: 2026-10-11 --- # 2026年9月，第三方 API 都发生了哪些变更 由 Harbyn 发布于 2026年10月11日。标签：data-report, breaking-changes, deprecations, ai-models。 Harbyn 的公开变更 Feed 记录了 2026年9月公布的 **706 项变更**，来自其追踪的 **[170 个厂商](https://harbyn.com/vendors)中的 87 个**。其中 **278 项**是开发者可能需要采取行动的变更：**83 项破坏性变更**、**29 次退役**（其中 17 次是 AI 模型退役）、79 项行为变更、47 项定价变更等。从 10月11日往后看，未来 90 天内有 **71 个截止日期**，其中 23 个是模型退役。 这是 Harbyn 的第一份变更报告。下文的每个数字都取自 2026年10月11日当天的 Feed，[统计方法](#统计方法)一节逐一说明了每个数字的统计口径。这些数字只针对 Harbyn 追踪的厂商，并不涵盖世上所有的 API。 ## 数据概览 | 指标 | 数值 | |---|---| | 9月公布的变更（Harbyn 追踪的厂商） | 706 | | 其中需要采取行动的变更（不含新发布和未分类公告） | 278 | | 破坏性变更 | 83 | | 公布的 AI 模型退役 | 17 次，涉及 12 个厂商 | | 退役生效前提前通知天数的中位数 | 14 天 | | 有明确日期的破坏性变更生效前提前通知天数的中位数 | 0 天 | | 2026年10月11日至2027年1月9日之间的截止日期 | 71 | ## 为什么只统计9月，而不是整个季度 Harbyn 的 Feed 于 2026年9月21日开始发布。9月更早的事件是从厂商自己的 changelog 和弃用页面补录的，但 Feed 中 7月和 8月公布的变更只有 24 项，数量太少，不足以描述那两个月的情况。因此本报告只覆盖 9月1日至 9月30日公布的变更。第一份完整的季度报告将覆盖 2026年第四季度。 ## 按类型划分的变更 | 类型 | 变更数 | |---|---| | 新功能或新发布 | 353 | | 破坏性变更 | 83 | | 行为变更 | 79 | | 未分类公告 | 75 | | 定价 | 47 | | 退役 | 29 | | 弃用 | 17 | | 速率限制 | 9 | | 政策 | 8 | | 安全 | 6 | | **合计** | **706** | 一半的条目是新东西：模型发布、新接口、新选项。这些会进入[雷达](https://harbyn.com/radar)，不计入下文的任何统计。未分类公告是我们已记录、但尚未分类的 changelog 条目。剩下的 **278 项变更**，才是可能导致代码出错、改变行为或改变账单的那些。 ## 变更来自哪里 这 278 项需要采取行动的变更，按发布厂商的类别划分如下： | 厂商类别 | 变更数 | |---|---| | AI 模型与 API | 111 | | 支付 | 44 | | 云服务 | 34 | | 开发者工具 | 29 | | 电商 | 25 | | 开发者平台 | 19 | | 消息 | 11 | | 财税（巴西） | 4 | | ERP | 1 | AI 厂商在 Harbyn 追踪的 170 个厂商中占 39 个（23%），却发布了这些变更中的 40%。 ## 谁发布的破坏性变更最多 | 厂商 | 破坏性变更 | |---|---| | [Stripe](https://harbyn.com/vendors/stripe) | 29 | | [Linear API](https://harbyn.com/vendors/linear) | 6 | | [Shopify](https://harbyn.com/vendors/shopify) | 6 | | [Neon](https://harbyn.com/vendors/neon) | 5 | | [Modal](https://harbyn.com/vendors/modal) | 4 | | [WooCommerce](https://harbyn.com/vendors/woocommerce) | 4 | 这些数字取决于各厂商记录变更的方式，因此它们更多反映的是发布风格，而不是稳定性： - **Stripe**：29 项全部属于同一次发布，即 [2026-09-30.endive](https://docs.stripe.com/changelog) API 版本及配套的 Stripe.js 版本，Stripe 对每项变更都单独记录一条。例如：[Checkout Sessions 移除 payment method types 参数](https://harbyn.com/changes/stripe/2026-09-30-endive-removes-the-payment-method-types-parameter-from-checkout-sessions)，以及 [Payment Intents 和 Setup Intents 移除同一参数](https://harbyn.com/changes/stripe/2026-09-30-endive-removes-the-payment-method-types-parameter-from-payment-intents-and-setup)。Stripe 以新 API 版本的形式发布破坏性变更；只有当集成升级其固定的版本时，这些变更才会影响到它。 - **Linear API**：`@linear/sdk` 的五个新主版本（93.0.0 到 97.0.0），以及 `@linear/import` 的一个新主版本。其中最新的 97.0.0 [仅支持 ESM](https://harbyn.com/changes/linear/2026-09-28-linear-97-0-0)。 - **Neon**：`@neon/sdk` 的五个包含破坏性变更的版本，例如 [7.0.0 移除了快照 slug](https://harbyn.com/changes/neon/2026-09-29-neon-sdk-7-0-0)。 - **Shopify**：变更遍及其 API、应用扩展和开发者工具，例如[移除 marketCurrencySettingsUpdate mutation](https://harbyn.com/changes/shopify/2026-09-22-removing-marketcurrencysettingsupdate-mutation)。 ## 9月公布的 AI 模型退役 十二个厂商，共十七次退役。表中日期是对该模型的请求停止工作（或在注明处被重定向）的日期。 | 厂商 | 模型 | 生效日期 | |---|---|---| | [Anthropic](https://harbyn.com/changes/anthropic/2026-09-30-claude-sonnet-4-5-model-retirement) | `claude-sonnet-4-5-20250929` | 2026年11月30日 | | [OpenAI](https://harbyn.com/changes/openai/2026-09-11-gpt-5-4-cyber-shutdown) | `gpt-5.4-cyber` | 2026年10月1日 | | [Google Gemini API](https://harbyn.com/changes/google-gemini/2026-09-30-veo-3-1-lite-generate-preview-shutdown-2026-10-22) | 三个 `veo-3.1` 预览模型 | 2026年10月22日（据 Google，为最早日期） | | [Mistral AI](https://harbyn.com/changes/mistral/2026-09-29-ocr-4-0-deprecated-and-scheduled-for-retirement) | `mistral-ocr-4-0` | 2026年9月30日 | | [Mistral AI](https://harbyn.com/changes/mistral/2026-09-29-z-ai-glm-5-2-deprecated-and-scheduled-for-retirement) | `zai-glm-5-2` | 2026年10月31日 | | [xAI API](https://harbyn.com/changes/xai/2026-09-02-grok-imagine-image-quality-retirement) | `grok-imagine-image-quality`，之后由 `grok-imagine-image-2.0` 提供服务 | 2026年11月2日 | | [Perplexity API](https://harbyn.com/changes/perplexity/2026-09-25-older-openai-models-retired-october-24-2026) | Agent API 和 Router API 上的七个较旧 OpenAI 模型 | 2026年10月24日 | | [DeepSeek API](https://harbyn.com/changes/deepseek/2026-09-10-previous-generation-v4-flash-models-retired) | V4 Flash 和 V4 Flash Vision Exp，模型名暂时路由到 V4.1 Flash | 2026年9月10日 | | [Groq](https://harbyn.com/changes/groq/2026-09-14-qwen-qwen3-6-27b-shutdown) | `qwen/qwen3.6-27b` | 2026年9月14日 | | [Together AI](https://harbyn.com/changes/together/2026-09-01-four-serverless-models-removed-september-14-2026) | 四个 serverless 模型 | 2026年9月14日 | | [Fireworks AI](https://harbyn.com/changes/fireworks/2026-09-12-upcoming-serverless-deprecation-older-deepseek-glm-muse-and-kimi-models) | Serverless 上较旧的 DeepSeek、GLM、Muse 和 Kimi 模型 | 2026年9月25日 | | [Cerebras](https://harbyn.com/changes/cerebras/2026-09-03-gemma-4-31b-availability-changes-on-public-endpoints) | 公共端点上的 `gemma-4-31b` | 公告时即已生效 | | [OpenRouter](https://harbyn.com/vendors/openrouter) | 来自其模型 API 的五条到期通知 | 2026年9月25日至12月31日 | 在 9月公布的全部 25 次有明确日期的退役中（包括模型及其他各类退役），提前通知天数的中位数为 14 天。 ## 厂商提前多久发出通知 对于每一项有明确日期、需要采取行动的变更，我们统计了从厂商公布到变更生效之间的天数。 | 类型 | 有日期的变更 | 提前通知中位数 | |---|---|---| | 退役 | 25 | 14 天 | | 弃用 | 5 | 168 天 | | 行为变更 | 10 | 15.5 天 | | 破坏性变更 | 32 | 0 天 | | 全部有日期、需要采取行动的变更 | 76 | 1 天 | 有明确日期的破坏性变更，通常在公布当天就生效。其中许多是需要你主动选用的新 SDK 主版本或新 API 版本，所以“0 天”往往意味着“在你升级时”，而不是“今天”。退役则不同：日期一到，旧模型或旧版本就会停止工作或改变行为，无论你升级与否，而提前通知的中位数只有两周。弃用的数字只基于五项变更，样本太少，不足以推而广之。 ## 未来 90 天内的截止日期 2026年10月11日至2027年1月9日之间，Feed 中共有 **71 个截止日期**：46 次退役、9 项弃用、8 项行为变更、4 项破坏性变更、2 项政策变更、1 项速率限制变更和 1 项安全变更。截止日期最多的厂商是 Azure OpenAI（13 个）、OpenRouter（8 个）、巴西的 SEFAZ 电子发票（6 个）和 Google Gemini API（5 个）。以下几项影响面较广： - **10月16日**：[Shopify API 版本 2025-10 停止支持](https://harbyn.com/changes/shopify/2026-09-21-api-version-2025-10-unsupported-2026-10-16)。固定该版本的调用此后将由最旧的受支持版本处理，因此即使你没有改动代码，响应也可能发生变化。 - **10月20日**：[Vertex AI 退役 gemini-2.5-pro、gemini-2.5-flash 和 gemini-2.5-flash-lite](https://harbyn.com/changes/vertex-ai/2026-10-09-gemini-2-5-models-scheduled-for-retirement)。 - **10月23日**：[OpenAI 移除旧版 GPT 快照](https://harbyn.com/changes/openai/2026-04-22-legacy-gpt-model-snapshots-shutdown)，包括 `gpt-3.5-turbo`、`gpt-4` 和 `gpt-4-turbo`。 - **11月2日**：[GitHub Actions 退役 macOS 14 runner 镜像](https://harbyn.com/changes/github/2026-10-01-github-actions-macos-14-runner-image-retirement)。 - **11月30日**：[Anthropic 退役 Claude Sonnet 4.5](https://harbyn.com/changes/anthropic/2026-09-30-claude-sonnet-4-5-model-retirement)。 - **12月1日**：[OpenAI 移除三个 GPT Image 模型](https://harbyn.com/changes/openai/2026-06-02-gpt-image-model-deprecations-shutdown)。 - **12月11日**：[OpenAI 移除 GPT-5 和 o3 快照](https://harbyn.com/changes/openai/2026-06-11-gpt-5-and-o3-model-deprecations-shutdown)。 最新列表见[截止日期页面](https://harbyn.com/deadlines)和[日历订阅](https://harbyn.com/calendar.ics)。 ## 统计方法 - **数据来源。** Harbyn 的变更 Feed，即以签名 JSON 形式发布在 [feed.harbyn.com/v1/feed.json](https://feed.harbyn.com/v1/feed.json) 的同一份数据，以 2026年10月11日当天的状态为准。该日之后添加的事件不计入，因此这些数字不会随 Feed 增长而变动。只统计通过校验的 Feed，已撤回的事件不计入。 - **覆盖范围。** 170 个厂商（146 个全球厂商，24 个巴西厂商），列于[厂商页面](https://harbyn.com/vendors)。Harbyn 未追踪的厂商不计入。 - **时间窗口。** 厂商公布日期在 2026年9月1日至9月30日之间的变更。另有 66 个条目带有 9月的日期，只是因为我们第一次读取厂商页面时它们就已在那里，本身没有日期；它们可能早得多，因此不计入。 - **需要采取行动的变更。** 除新功能和新发布（353 项）以及未分类公告（75 项）之外的所有类型。 - **提前通知。** 从厂商公布到生效日期的天数，统计对象是有生效日期（具体某一天；若厂商只给出月份，则取该月第一天）、需要采取行动的变更，已取消的不计入。其天数计算方式与 Feed 自身的提前期规则相同。 - **未来的截止日期。** 日期落在 2026年10月11日至2027年1月9日之间的有日期变更，不论何时公布，不含新发布，已取消的不计入。 - **一个计数代表什么。** 一个事件就是厂商记录的一项变更。将一次发布中的每项变更分别列出的厂商，其事件数会多于汇总记录的厂商，上文的 Stripe 就是如此。 按同样的规则，Harbyn 自己在 9月的表现：在 76 项有日期、需要采取行动的变更中，Feed 在生效前发布了 32 项，提前天数的中位数为 27 天。其余 44 项是在生效后才记录的；它们作为历史保留，从不计为警告。 ## 在你自己的代码中找出这些变更 上面的数字是跨厂商的统计。对一个代码库而言，重要的是其中哪些会影响到它。 - `npx harbyn scan` 在你的仓库中运行开源扫描器。它会找出你的代码所用的模型 ID、API 版本、接口和 SDK 版本，与 Feed 进行匹配，并输出文件和行号、截止日期以及厂商指明的替代方案。与你代码有关的任何内容都不会离开你的机器。详见[文档](https://harbyn.com/docs)。 - [截止日期页面](https://harbyn.com/deadlines)、[日历订阅](https://harbyn.com/calendar.ics)和签名 Feed 本身都是公开的，无需账号。 - 编程智能体可以通过 Harbyn 的只读 MCP 服务器 `https://api.harbyn.com/mcp` 提出同样的问题，例如“哪些 OpenAI 模型将要退役、何时退役”。配置方法见[文档](https://harbyn.com/docs)。