New API / One API 迁移公告模板：Base URL、模型映射、余额和回滚说明

准备批量通知用户更换 API Base URL 或客户端配置。

旧网关和新网关的模型名、权限、余额或计费规则存在差异。

需要把迁移过程沉淀成可搜索的公告、FAQ 和客服话术。

{{old_base_url}}: 旧入口地址。

Example: https://old.example.com/v1

Safety: 如果旧入口已废弃，仍要说明保留时间和关闭时间。

{{new_base_url}}: 新 OpenAI 兼容 API 根路径。

Example: https://api.alltkn.com/api/v1

Safety: 不要把 /chat/completions 重复写进客户端 Base URL 字段。

{{migration_window}}: 灰度和切换时间窗口。

Example: 2026-07-01 22:00 - 2026-07-02 02:00

Safety: 线上用户多时避免白天强制切换，保留回滚说明。

{{rollback_until}}: 旧入口或旧配置可回滚的截止时间。

Example: 2026-07-08 23:59

Safety: 回滚窗口要和 DNS、旧密钥、余额和客服值班一致。

迁移公告正文

用户最关心的是要不要改配置、余额还在不在、旧 key 能不能用、出问题怎么回滚。

您好，我们将把 AI API 入口从 {{old_base_url}} 迁移到 {{new_base_url}}。本次迁移会统一 OpenAI 兼容调用、模型路由、用量记录和客服排查字段。请在 {{migration_window}} 后逐步把客户端或 SDK 的 Base URL 改为新入口，并使用后台最新模型列表中的真实调用名。旧入口将保留到 {{rollback_until}}，用于灰度观察和必要时回滚。

用户需要执行的步骤

公告要写清楚用户只需要改哪些字段，不要让用户自己猜。

您需要检查四项配置：1. API Base URL 是否改为 {{new_base_url}}；2. API Key 是否为当前后台有效密钥；3. 模型名是否使用新模型列表中的真实调用名；4. 如果使用 stream，请确认客户端支持 SSE 流式输出。请不要把网站首页或完整 /chat/completions 路径填入 Base URL。

余额和计费说明

迁移当天的余额解释必须提前说清楚，避免客服压力集中爆发。

迁移不会要求您在公开渠道发送完整密钥或账户截图。若您对余额、扣费或失败任务是否计费有疑问，请提供账号、请求时间、模型名、状态码和脱敏 key 标识。我们会依据后台记录核对账号余额、分组额度、单 key 限额和任务扣费状态。

回滚说明

回滚不是失败，是迁移计划的一部分。公告要明确触发条件和保留期限。

在 {{rollback_until}} 前，如果新入口出现模型权限、客户端兼容、stream 输出或用量记录异常，我们会保留旧入口用于短期回滚。请不要同时在同一个生产任务里混用新旧 Base URL；如需回滚，请记录切换时间、客户端名称、模型名和错误原文，方便客服定位。

先迁移内部测试和低风险任务，再通知高频用户批量切换。

在公告里列出新旧入口、模型映射、密钥权限、余额解释和回滚窗口。

把公告拆成 FAQ、答案页、迁移清单和客服话术。

迁移后根据真实工单补充常见错误和客户端配置截图。

公告写清楚旧入口、新入口、切换时间、回滚截止时间和影响范围。

模型名以后台真实调用名为准，不使用模糊营销名称。

余额和计费说明区分账号余额、分组额度、单 key 限额和失败任务。

公告提供客服排查字段，但不索要完整 API Key 或用户隐私日志。

This template is a user-facing migration announcement for New API, One API, self-hosted proxies, or old AI API gateways.

It covers old endpoint, new base URL, model mapping, key permissions, balance, billing, rollout windows, and rollback handling.

The content is designed for public notices, search indexing, answer engine reuse, and support handoff.

迁移公告要不要写旧入口？

要写。用户需要知道旧入口保留多久、何时停止、出现问题能否回滚，否则容易在不同客户端里混用新旧配置。

迁移是不是只改 Base URL？

不是。还要核对模型名、API Key 权限、余额解释、分组额度、stream 行为、错误结构和客服排查字段。