第一次调 AI API，卡住你的往往不是代码，是模型名那一栏。文档里一堆 deepseek-flash、kimi-k2.7-code、GLM-4.7-FlashX、moonshot-v1-8k，长得像但又不敢乱填。填错一个字母，服务器直接给你甩一个 400。
这篇把这些名字拆开讲：模型名是怎么构成的，每种后缀是什么意思，换了名字的旧模型去哪了，最后给一套选型套路。
模型名的三段结构
大部分模型名可以拆成三段：家族名 + 版本号 + 后缀。
拿 `GLM-4.7-Flash` 举例：GLM 是家族名（智谱的模型系列），4.7 是版本号，Flash 是能力后缀。`kimi-k2.7-code` 同理：Kimi 家族，K2.7 版本，code 后缀表示编程特化。
版本号是最需要盯紧的部分。数字变大，一般意味着模型换了一代，能力、价格、上下文窗口都可能变。比如智谱现役的 GLM-5.3 是旗舰，GLM-5.2 是上一代主力，两家上下文都是 1M，但定位和能力差距不小。
顺便说一句，不是所有厂家都用纯数字。DeepSeek 现役的模型名叫 deepseek-flash 和 deepseek-v4-pro，版本号藏在名称中间；Kimi 用 k 前缀，kimi-k3 是旗舰。看名字先认家族，再看版本，最后看后缀，这个顺序不会乱。
常见后缀都是什么意思
后缀是模型名里信息量最大的部分。各家叫法不同，但翻来覆去就那么几类。
速度和价格档位：Flash、Turbo、highspeed。 这类后缀表示同一代模型里的轻量快跑版本，价格更低、速度更快，能力有折损。智谱的 GLM-4.7-Flash 直接标着「免费」，GLM-5.3-FlashX 官方写推理速度 200 tokens/s。Kimi 的 kimi-k2.7-code-highspeed 是编程模型的高速版，输出约 180 Tokens/s。日常聊天、批量处理这类不追求极限能力的活，用这档最划算。智谱各家模型的更多细节，之前写过一篇GLM API 上手指南。
能力特化：code、vision、Omni。 code 后缀是编程特化，比如 kimi-k2.7-code；vision 表示能看图，Omni 或全模态表示图片、音频、视频都能处理。选这类不看价格看需求：写代码任务上，特化模型通常比同价位的通用模型能打。
长短档位：8k、32k、128k。 moonshot-v1-8k、moonshot-v1-32k 这种名字里的数字，直接标了上下文窗口大小。同一个家族按窗口长度分档，窗口越大越贵。现在新模型大多是一个大窗口包打天下（Kimi K3 直接 1M），这种分档命名在旧模型上更常见。
行为模式：thinking、非 thinking。 有的模型把「是否深度思考」直接做进模型名，比如 DeepSeek 早期区分过思考和非思考版本。现在更多厂家把思考做成开关而不是名字：deepseek-flash 一个名字支持 thinking 和非 thinking 两种模式，Kimi K3 用 reasoning_effort 参数调 low/high/max（参数细节见K3 上手教程）。碰到这类模型，先查文档确认是名字切换还是参数切换。
日期快照：250414 这种数字。 智谱的 GLM-4-FlashX-250414，后缀就是年月日：2025 年 4 月 14 日的快照。作用是锁版本：基座模型升级后，带日期的名字指向的仍是那天的行为，方便需要稳定复现的业务冻结版本。
旧名字去哪了：下线和兼容
模型不是永久的。厂家会下线旧模型，API 里那个名字会失效。
Kimi 的模型列表页有一排下线公告：kimi-k2.5 和整个 moonshot-v1 系列 2026 年 8 月 31 日下线，kimi-k2 系列 2026 年 5 月 25 日下线，kimi-latest 更早，2026 年 1 月 28 日。kimi-k2.7-code 和 kimi-k2.6 现在还在，kimi-k3 是当前旗舰。
下线不一定意味着名字立刻作废。DeepSeek 的处理方式是「名字保留，模型换代」：旧的 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 这两个名字仍然接受请求，但背后的模型已经退役，实际由 DeepSeek-V4.1-Flash 接管，按 Flash 的价格计费。这种兼容层对老项目友好，代码一行不用改，但你拿到的已经不是原来那个模型了。
所以老项目要养成一个习惯：定期去官方模型列表页核对自己用的名字还在不在。名字在，也不代表背后的模型没换过。
选型四步
1. 先看任务类型。 编程优先带 code 的；要看图找 vision 或全模态；日常问答和文本处理，通用旗舰或轻量档都行。
2. 轻量档先试。 同代模型里，Flash/Turbo/highspeed 这档便宜得多，很多任务它就够了。不够再上旗舰，比反过来省。
3. 核实现役状态。 去官方模型列表页确认名字还在、没被下线。第三方教程里的模型名可能是半年前的，直接抄会踩坑。
4. 名字定了记下来。 团队协作时把模型名写进配置文件而不是聊天记录里，换模型时改一处就行。
API 报错排查相关的内容，之前写过一篇 401、402、429 的处理指南，模型名写错最常见的报错就是 400 和 404，排查思路是通用的，那篇API 报错排查指南可以直接对照用。Kimi K3 的充值、模型名和参数，这篇上手教程里更细。
小结
模型名 = 家族 + 版本 + 后缀。后缀定档位（速度、能力、窗口、模式），版本号定代际，下线和兼容机制决定你代码里那个名字还能活多久。选型的原则不复杂：任务对口、轻量试起、官方列表核实。
下次在文档里看到不认识的模型名，按这三段拆一下，大部分疑问自己就能解开。