TheRouter.aiTheRouter.ai
← 全部文章

跨供应商 LLM API 变更日志和版本更新监控实战指南

一份实用指南，讲清楚如何跟踪 OpenAI、Anthropic、DashScope、DeepSeek 和 SiliconFlow 的 API 变更日志、模型下线时间表、定价更新和破坏性变更。

· TheRouter

30 秒看完要点：每家 LLM API 供应商把模型下线、定价调整和破坏性 API 更新放在不同的页面，用不同的格式，给不同的提前通知期。如果你同时用了多家供应商，就需要一套监控系统同时盯住所有变更渠道，在出事之前把可执行的告警推到团队面前。这篇指南会依次讲清楚每家供应商的变更公告在哪里、有哪些现成工具可以用、怎样搭出一套防住"出了故障才发现"的监控体系。

OpenAI 兼容指供应商提供一个 chat-completions 接口，其请求与响应结构与 OpenAI API 契约足够接近——只需替换三个值（API key、base URL、模型名），原来的 OpenAI SDK 调用即可直接工作。最小实践面是POST /v1/chat/completions 带 messages、model， 并返回 OpenAI 形式的流式响应。

为什么 LLM API 的监控比传统 API 更紧迫

传统 REST API 的变更节奏通常很慢。LLM API 不一样。OpenAI 从 2023 年至今已经下线了数十个模型快照，每个都有各自的停用日期和替代目标。Anthropic 大约每 12 个月更替一批模型，提前至少 60 天通知。DashScope（阿里云百炼）把多个下线批次合并成了 2026 年 10 月 10 日的统一截止日期，涉及超过 30 个模型 ID。DeepSeek 也公布了重大的定价调整计划。

漏掉一次下线通知的代价很高。你的 API 调用可能开始报错，也可能被静默地切换到行为不同的模型上。你的成本预估会因为没注意到定价变化而失准。你的合规状态也可能在供应商更新数据处理政策后发生变化。

处理得好的团队把供应商变更日志监控当基础设施来建，而不是靠某个人记得去看。

各家供应商的变更公告地图

每家供应商把更新信息分散在多个不同的页面上。下面逐个说明去哪里找。

OpenAI

OpenAI 的模型和 API 更新分布在多个不同的页面上。

页面URL内容检查频率
下线页面developers.openai.com/api/docs/deprecations所有已下线和即将下线的模型，包含具体停用日期和替代目标每周
API 变更日志developers.openai.com/docs/changelogAPI 变更、新功能、下线通知、行为更新每天
博客openai.com/blog重大模型发布、研究成果、产品上线每隔数小时
定价页面openai.com/api/pricing所有模型的 token 定价，包含批量和缓存输入价格每周
状态页面status.openai.com实时故障和维护信息自动监控

OpenAI 的下线政策：GA 模型至少提前 6 个月通知，专用变体（chat、codex、deep-research 快照）至少提前 3 个月，preview 模型可能只有 2 周通知期。下线页面是最需要优先监控的页面，因为上面写着你的代码会在哪天停止工作。

Anthropic

页面URL内容检查频率
模型下线platform.claude.com/docs/en/about-claude/model-deprecations活跃、已下线和已退役的模型，包含退役日期和推荐替代每周
变更日志docs.claude.com/en/release-notes/overview.mdAPI 和平台变更、新功能每周
博客anthropic.com/news重大模型发布和研究公告每隔数小时
定价platform.claude.com/docs/en/about-claude/pricing各模型 token 定价每周
状态页面status.anthropic.com故障和维护信息自动监控

Anthropic 会在模型退役前至少 60 天通知有活跃部署的客户。社区项目 endoflife.date/claude 提供了一个汇总视图，把 Claude 各模型的生命周期日期集中展示。

DashScope（阿里云百炼）

页面URL内容检查频率
模型下线help.aliyun.com/zh/model-studio/model-depreciation所有已下线 Qwen 和第三方模型的停用日期每周
新发布模型help.aliyun.com/zh/model-studio/newly-released-models新模型上线公告和发布日期每周
阿里云公告aliyun.com/notice/（搜索 "model studio"）正式的下线公告文件，附带迁移指引每周
定价help.aliyun.com/zh/model-studio/model-pricing各模型定价，包含免费额度和促销价每两周
控制台提醒百炼控制台产品内的下线横幅和邮件/短信告警被动接收

DashScope 的特别之处在于，它通过阿里云公告系统以正式文件形式发布下线通知（例如 notice/118344、notice/118345）。这些公告中会列出具体的替代模型 ID 和迁移时间线。截至 2026 年 8 月，DashScope 已把多个下线批次合并为 2026 年 10 月 10 日这一个统一截止日期。

DeepSeek

页面URL内容检查频率
API 文档变更api-docs.deepseek.comAPI 变更和新功能每周
新闻/公告api-docs.deepseek.com/news/模型发布、下线通知、定价变更每周
定价api-docs.deepseek.com/quick_start/pricing各模型 token 定价每周

DeepSeek 的变更公告渠道比其他供应商更少。下线通知在新闻栏目中发布（例如 2026 年 4 月的公告，宣布 deepseek-chat 和 deepseek-reasoner 在 7 月 24 日退役）。定价调整通过媒体报道披露，随后在定价页面上确认。

SiliconFlow

页面URL内容检查频率
定价siliconflow.com/pricing各模型定价，包含免费模型每周
文档docs.siliconflow.cnAPI 变更、新模型、限流更新每周
模型页面siliconflow.com/models可用模型及其状态每周

SiliconFlow 主要通过文档和定价页面发布更新。模型可用性变化（新增模型、移除模型）出现在模型页面上。

自动化监控的工具和方案

git-scraping 模式

git-scraping 是 Simon Willison 推广的一种方法，用 GitHub Actions 定期抓取供应商页面并把内容提交到代码仓库。Git diff 能精确显示什么内容在什么时间发生了变化。deprecations.info 项目就是用这种方法跟踪 AI 模型停用时间的。

# .github/workflows/scrape-deprecations.yml
name: Scrape LLM deprecation pages
on:
  schedule:
    - cron: '0 */6 * * *'  # 每 6 小时
jobs:
  scrape:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Fetch OpenAI deprecations
        run: |
          curl -s https://developers.openai.com/api/docs/deprecations.md \
            -o data/openai-deprecations.md
      - name: Fetch Anthropic deprecations
        run: |
          curl -s https://platform.claude.com/docs/en/about-claude/model-deprecations.md \
            -o data/anthropic-deprecations.md
      - name: Commit changes
        run: |
          git config user.name "deprecation-bot"
          git config user.email "bot@example.com"
          git add -A
          timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
          git diff --cached --quiet || \
            git commit -m "update: ${timestamp}" && git push

页面内容一旦发生变化，提交的 diff 就能告诉你哪些模型被新增到了下线列表或从列表中移除了。你可以把 GitHub 通知或 webhook 接入团队的告警渠道。

社区下线追踪器

有几个社区项目在多供应商维度上汇总下线数据。

  • quora/model-deprecation-tracker（GitHub）跟踪 OpenAI、Anthropic、Vertex AI、Bedrock、Gemini 的下线时间表，生成 iCal 订阅源，可以导入日历并在停用前 7 天和 30 天收到提醒。
  • endoflife.date（endoflife.date/claude）是社区维护的 Claude 模型生命周期追踪，提供结构化数据（JSON API 可用）。
  • LLM Model Deprecation Check（GitHub Action）是一个 GitHub Action，检查你代码中的模型 ID 是否已被下线或退役，并建议替代方案。

页面差异检测服务

商业页面差异检测服务如 PageCrawl、Visualping 或 Distill.io 可以监控供应商页面并在内容变化时发送告警。对于没有 RSS 源或结构化变更日志的页面，这些服务特别有用。

RSS 和邮件订阅

  • OpenAI 发布开发者邮件通讯，可以在 API 控制台订阅。
  • Anthropic 会给有活跃模型部署的客户发送下线邮件通知。
  • DashScope 通过阿里云通知系统发送短信和邮件告警（在阿里云控制台的消息中心配置）。

搭建监控体系的清单

以下是一份可以直接用于生产环境的 LLM API 变更日志监控搭建清单。

第 1 步：盘点你的模型使用情况

有效监控的前提是知道自己在用什么。

# 找出代码库中引用的所有模型 ID
grep -rn "model[\"':= ]*[\"']" src/ --include="*.py" --include="*.ts" --include="*.js" \
  | grep -oP '(?<=["\x27])[a-z0-9][-a-z0-9.]*(?=["\x27])' \
  | sort -u

把每个模型 ID 映射到对应的供应商，检查它是否已经出现在任何下线列表上。如果你用的是带日期后缀的快照（例如 gpt-5-2025-08-07），它们是最容易被下线的。

第 2 步：搭建自动页面监控

至少要监控以下页面（选一种工具）。

  1. OpenAI 下线页面
  2. Anthropic 模型下线页面
  3. DashScope 模型下线页面
  4. DeepSeek 新闻页面
  5. 各供应商的定价页面

第 3 步：建一个下线日历

把已知的停用日期导入共享日历。quora/model-deprecation-tracker 项目可以生成用于此目的的 iCal 订阅源。在 T-90、T-30 和 T-7 天分别设置提醒。

第 4 步：在 CI 中加入检查

在 CI 步骤中对比你的模型 ID 和维护好的下线列表。LLM Model Deprecation Check 这个 GitHub Action 能自动完成这件事。或者维护一份本地 JSON 文件记录模型 ID 和预期状态，当某个模型标记为已下线且停用日期在 30 天内时让构建失败。

第 5 步：把告警路由到正确的频道

下线告警应该推送给负责 LLM 集成的工程团队，而不是一个通用通知频道。定价告警也应该同时触达财务或账单负责人。用 webhook 集成把不同类型的变更路由到不同的 Slack 频道、PagerDuty 服务或邮件组。

选择方案的决策矩阵

维度人工查看git-scraping页面差异检测服务CI 模型审计
搭建成本无低（1-2 小时）低（几分钟）中等（半天）
持续成本高（人力时间）免费（GitHub Actions）$10-50/月免费（CI 运行分钟数）
能捕获下线取决于有人记得看能，可靠能，可靠能，在部署时
能捕获定价变化取决于有人记得看能能不能
能捕获 API 破坏性变更取决于有人记得看有时能有时能不能
适合团队规模1-2 人3-10 人任意规模有 CI 的任意规模

对大多数团队来说，用 git-scraping 监控变更日志页面，加上 CI 模型审计保障部署安全，这个组合能以最低成本覆盖最多风险。

路由层带来的额外便利

把 LLM API 请求通过 TheRouter 这样的网关来路由时，路由层自然成为观察模型使用模式的入口。如果你正在路由的某个模型 ID 出现在了下线列表上，路由配置就是你唯一需要更新模型映射的地方。结合回退路由，更新一条路由规则就能替换掉已下线的模型，不需要重新部署应用代码。

我们把 OpenAI 兼容的请求路由到配置好的供应商，并在已上线的产品路径支持的情况下提供供应商/模型路由和回退。这意味着如果供应商 A 下线了某个模型，一条路由规则就能把流量重定向到供应商 B 上的等效模型，你的应用代码不需要任何变更。

信息来源

帮助与联系