Spring AI 2.0.0 GA 官方原生 ChatModel 清单

Spring AI 2.0.0 GA 官方原生 ChatModel 清单（核心内置、官方维护、独立 Starter）

重要定义：原生 Model = Spring 官方单独开发适配器、绑定厂商官方 SDK、独立 starter、完整支持厂商独有能力 区分：OpenAiChatModel 既是 OpenAI 原生实现，同时兼容 OpenAI 协议网关（DeepSeek 兼容接口、豆包兼容接口、OneAPI 等都能用它访问，但这属于兼容模式≠原生 DeepSeek 适配器）

一、官方原生内置 ChatModel（7 套，2.0 GA 正式收敛后的主力）

表格

二、补充重要信息（极易踩坑，结合你之前的选型问题）

1. ❌ 这些国产模型没有官方原生适配器（重点！）

字节豆包、通义千问、智谱 GLM、月之暗面 Kimi Spring AI 2.0 核心包移除了智谱原生实现，不再维护； 👉 只能使用 OpenAiChatModel（OpenAI 兼容端点模式）接入 也就是你之前纠结的痛点：

接入豆包 / 通义千问，没有原生 Model 可选，只能走兼容模式，厂商独有特性会受限。

2. OpenAiChatModel「双重身份」区分（重中之重）

1. 原生模式：baseUrl=https://api.openai.com → 标准 GPT 原生调用
2. 兼容网关模式：baseUrl=https://api.deepseek.com/v1 / 豆包兼容地址 ⚠️ 这里虽然能连通 DeepSeek，但≠ DeepSeekChatModel 原生实现 👉 无法使用 DeepSeek 原生特性：R1 reasoning_content 原生解析、useProviderStructuredOutput、模型专属参数

3. 2.0 版本重大改动（对比 1.x）

1. 清理大量小众厂商原生适配器（智谱、MiniMax 等不再官方维护）
2. 全部原生适配器改为基于厂商官方 SDK，废弃手写 HTTP 客户端
3. OpenAI 整合为单一 SDK 实现，移除旧 Azure 独立模型类；Azure OpenAI 现在也通过OpenAiChatModel配置访问
4. Vertex AI Gemini 被废弃，统一迁移到GoogleGenAiChatModel

三、结合你的业务选型总结（承接上一轮对话）

1. 如果你调用 DeepSeek 两条路线：
   • 方案 A：DeepSeekChatModel【原生】→ 推荐，完整支持思考链、原生结构化输出
   • 方案 B：OpenAiChatModel【兼容模式】→ 简单问答可用，高阶能力缺失
2. 调用豆包、通义千问 无原生适配器，只能 OpenAiChatModel + 厂商兼容 endpoint，接受兼容模式带来的限制
3. 多模型混合架构最简工程建议

   plaintext

   DeepSeek直连 → DeepSeekChatModel（原生）
   豆包/通义千问 → OpenAiChatModel（兼容网关）
   

   上层代码统一依赖 ChatClient，不绑定具体实现类。

四、快速避坑一句话

不要混淆：能通过 OpenAI 兼容接口连上 ≠ 拥有原生适配器。只有上面表格列出 7 个才有专属原生 Model。