如何解读 AI 模型名称：别名与固定版本

打开任意一个 AI API 页面，你都会看到像 deepseek-flash、deepseek-v4-pro 或 DeepSeek-V4-Flash-0731 这样的名称。它们看起来像标签，但你填入 model 字段的字符串决定了哪个模型来回答以及你会被如何计费。本指南将说明如何解读这些名称、为什么同一个名称可能在你不知情的情况下发生变化，以及在把 id 粘贴进代码之前应该检查什么。

模型名称的构成#

以 DeepSeek-V4-Flash-0731 为例，把它拆成几部分：

有两点需要注意。后缀是一种约定，而非定律：1017 与 DeepSeek-V4.1-Flash-1017 的发布日期（2026 年 10 月 17 日）相符，但请务必在模型页面上确认，不要靠猜测。另外，文档页面中写的名称（DeepSeek-V4-Flash）并不总是 API 接受的字符串（deepseek-v4-flash-0731）：显示名称是给人看的，id 是给代码用的。

Flash 与 Pro#

开发者通常为同一代模型发布多个层级。Flash 通常是更快、更轻的层级，面向高吞吐量工作：聊天、信息提取、智能体循环。Pro 通常是更大的层级，用于更难的任务。这些词是开发者自己的营销用语，因此不同系列之间不可比较：一家公司的 Flash 与另一家公司的 Flash 规模并不相同。重要的是 deepseek-flash 和 deepseek-v4-pro 是两个不同的模型名称，所以无论你用哪一个，都要查看它的价格表。如果你切换了层级，请重新查看价格表。

别名与固定版本#

id 有两种，它们的区别是本文最重要的内容。

• 别名 —— 提供商将其指向某个模型、之后可能重新指向其他模型的名称。deepseek-flash 就是一个别名：截至 2026 年 10 月 22 日，DeepSeek 的文档称它由 DeepSeek-V4.1-Flash-1017 提供服务，而你的调用方式保持不变。明天同一个字符串可能指向更新的构建。
• 固定版本 —— 包含构建信息的 id，例如 deepseek-v4-flash-0731。它指向一个具体构建，因此你昨天测试得到的回答，今天应该仍来自同一个构建。

别名很方便：无需修改代码就能获得改进。固定 id 可预测：适合测试、评估、报告，以及任何行为变化会让你措手不及的场景。两者没有哪个“更好”；要有意识地选择。

同一个名称可能在你不知情的情况下发生变化#

DeepSeek 在 2026 年 10 月的变更就是一个现成的例子。根据 2026 年 10 月 22 日查阅的 DeepSeek 文档：

• deepseek-flash 目前由 DeepSeek-V4.1-Flash-1017 提供服务；
• 旧名称 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 仍被接受，但这些模型已退役，因此请求会转到 DeepSeek-V4.1-Flash-1017，并按 Flash 价格计费；
• deepseek-v4-pro 是一个独立的、当前的模型名称。

所以你的旧代码可能继续正常工作，但运行的模型已经与你编写它时不同。如果你想要的就是最新版本，这没问题；但如果你要跨周比较结果，这就是个陷阱。该文档页面没有发布日期，因此请把这一映射视为在上述日期成立，并在需要时重新查阅。模型本身的变化见 DeepSeek-V4.1-Flash-1017 is out。

把 id 放进代码前要检查什么#

1. 从你实际调用的提供商的文档中复制 id。 不同提供商对同一系列的命名不同，所以调用 CheapTokens 时就从 CheapTokens 文档取 id，调用 DeepSeek 时就从 DeepSeek 文档取 id。不要混用。
2. 决定：用别名还是固定版本？ 如果字符串中没有日期或构建后缀，就假定它可能会变动。
3. 检查 base URL 和 API 风格。 CheapTokens 在 https://api.cheaptokens.dev/v1 提供 OpenAI Chat Completions 和 Anthropic Messages 格式；DeepSeek 自己的 API 使用 https://api.deepseek.com（OpenAI 风格）和 https://api.deepseek.com/anthropic（Anthropic 风格）。正确的 id 配错误的 base URL 会报错。
4. 打开恰好对应那个 id 的价格表，并记下日期。价格属于某个模型，而不属于某个系列。
5. 把 id 放在一个地方（配置文件或环境变量），而不是散落在代码各处。
6. 记录实际回答的模型。 OpenAI 风格的响应带有 model 字段；把它和你的结果一起保存。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

# Take the exact id from the CheapTokens docs; this one is an example.
MODEL_ID = os.environ.get("MODEL_ID", "minimax-m2.7")

response = client.chat.completions.create(
    model=MODEL_ID,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)

print("asked for:", MODEL_ID)
print("answered by:", response.model)
print(response.choices[0].message.content)

打印出的两行正是值得养成的习惯：你请求了什么，以及什么回答了。绝不要硬编码密钥；参见 What is an API key and how to store it safely。如果这是你第一次调用，请从 Your first API request with CheapTokens 开始。

按版本比较价格和结果#

大多数困惑来自比较了错误的东西。在比较两个价格或两个回答之前，请为双方都写下：确切的 id、提供商和日期。两个都写着“Flash”但代际或构建后缀不同的 id，是发布日不同的不同模型。新闻帖中的基准测试也是如此：它们属于帖子中指定的那个构建，并不构成对任何其他 id 的承诺。

反过来也一样。当你用自己的提示词测试模型时，保持提示词集合固定，一次只改变一个因素：id 或提示词，不要同时改。比较时要统计 token？What is a token 解释了这些数字是如何计量的。

可供练习的示例 id#

CheapTokens 对所有模型使用同一个余额，因此你可以用同一个密钥切换 id：

• MiniMax-M2.7（minimax-m2.7，网关 id MiniMaxAI/MiniMax-M2.7）：180K 上下文，最多 8,192 个输出 token，任何时段同一价格。输入 $0.05、输出 $0.15 每 1M token，均低于 OpenRouter 的参考价。

下表针对 100,000 输入和 20,000 输出 token 的小任务实时重新计算，并附 OpenRouter 一列作为参考：

注意每一行都是一个具体的 id。如果你把 minimax-m2.7 换成另一个 id，你同时改变了模型和价格。

快速回顾#

• model 字符串决定了哪个模型回答以及花费多少。
• 没有构建后缀的 id 很可能是别名，可能会被重新指向；带构建信息的 id 是固定版本。
• 旧名称可能继续正常工作，却在悄悄运行更新的模型，正如 2026 年 10 月 22 日 DeepSeek 文档中的 deepseek-v4-flash。
• Flash 和 Pro 是同一系列内的层级，不是通用的规模。
• 始终从你调用的提供商的文档中复制 id，并记录实际回答的模型。

准备好试试了吗？获取密钥、充值余额，然后用 CheapTokens 文档中的模型 id 发送上面的代码片段。