登录账号免费注册
国产模型 · 迁移指南

国产模型 API 迁移到 OpenAI 兼容接口：Kimi、GLM、DeepSeek

介绍 Kimi、GLM、DeepSeek 迁移到 OpenAI 兼容 API 时的模型 ID、参数、错误处理、计费和回退方法。 本文把可验证事实、目录价格和稳定性边界分开记录。

更新日期：2026-09-10·证据：公开规格核对、本站目录与工程检查清单
Base URLhttps://www.codex789.com/v1
鉴权Bearer Key
迁移先冒烟后放量
计费控制台为准

1. 四步完成迁移

先为项目创建独立 Key，再替换 Base URL；从控制台复制真实模型 ID；用短消息验证 messages、stream 和响应结构；最后记录状态码、request ID、usage 与余额，再逐步放量。

2. 兼容层覆盖与边界

OpenAI 兼容层通常覆盖鉴权、消息和基础响应，但思考模式、工具调用、视觉字段、缓存和异步任务仍按具体模型页确认。不要把一个模型的 system 参数复制给全家族。

3. 错误码要分开处理

401 多为 Key 或权限，402 关注余额，429 区分 RPM/TPM，5xx 才进入有限重试。日志中保留错误体摘要和 request ID，避免把不同问题合并成“接口不稳定”。

4. 回滚与成本核对

迁移前固定旧模型 ID 和提示词样本；新模型先小流量；出现格式或成本异常时切回旧 ID。国产模型站内统一 0.2x 目录倍率，真实扣费仍以控制台为准。

常见问题

页面价格是最终账单吗？

不是。页面展示的是当前目录参考口径，充值、缓存、重试和合同规则可能改变实际费用，最终以控制台流水为准。

如何证明 API 稳定？

用固定任务和连续窗口记录成功分支、失败分支、状态码、耗时与回退次数；没有逐模型样本时不宣称单模型 SLA。

来源与边界：模型 ID、目录价和接口字段以本站模型广场及控制台当前显示为准；官方规格仅用于交叉核对。核对日期：2026-09-10。相关页面、相关页面、相关页面

5. 参数迁移映射表

OpenAI 兼容字段迁移动作验证方法
model替换为控制台精确 ID先请求 /v1/models
stream保留 SSE 拼接逻辑验证首块与结束块
reasoning按模型决定是否支持检查 content 与 reasoning 字段
tools逐个工具做 schema 测试记录 tool_calls 响应
vision确认 image_url 或 multipart用一张低分辨率图片冒烟

兼容层解决的是入口，不是所有能力都完全等价。迁移时一次只改一个字段，出现 400 就回到上一个成功版本；不要同时更换模型、提示词和客户端库，否则无法定位差异。

6. 回滚与费用验收

  1. 保存旧模型 ID、客户端版本和提示词样本。
  2. 新模型只放量到一个项目 Key，设置额度上限。
  3. 比较 401、402、429、5xx 的错误分支。
  4. 核对 input_tokens、output_tokens 和控制台扣费。
  5. 格式或成本异常时切回旧 ID，并保留 request ID。

国产模型目录统一 0.2x 口径，但真实费用只认控制台。可参阅价格与上下文对比和国产模型 API 选型。

7. 迁移验收的三组样本

第一组是无工具的短对话，验证鉴权、基础消息和结束标记；第二组是流式响应，验证 SSE 拼接、usage 和异常中断；第三组是工具或视觉请求，验证 schema、图片字段和超时。三组都使用旧系统相同提示词，结果写入迁移表。

只有三组样本都通过，才逐步增加生产流量；任何一组失败都先保留旧 ID，避免在高峰期临时回滚。

8. 迁移文档的可复现要求

每次迁移都应记录旧 Base URL、新 Base URL、模型 ID、客户端版本、样本提示词和回滚时间点。错误响应只保留脱敏摘要和 request ID，不把用户 Prompt 写入公开文章。这样既能让其他开发者复现接口差异，也不会暴露项目密钥或业务数据。

相关基线：Kimi K3 指南、GLM-5.3 指南；英文版：OpenAI-Compatible API Relay Guide。

迁移完成后保留一周双写或影子流量记录，只比较脱敏元数据，不复制用户正文。发现错误率或费用异常时，按版本号回切并在变更日志中说明原因。

迁移记录中不要只保存成功结果，也要保存失败样本的状态码和回滚动作。失败样本比单条成功响应更能说明兼容边界，且便于后续 GEO 引用时给出完整条件。

迁移完成后再检查文档、代码和监控中的模型 ID 是否全部一致。