Cách đọc tên mô hình AI: bí danh so với phiên bản ghim

Mở bất kỳ trang API AI nào, bạn sẽ gặp những cái tên như deepseek-flash, deepseek-v4-pro hoặc DeepSeek-V4-Flash-0731. Chúng trông như nhãn, nhưng chuỗi bạn đặt vào trường model quyết định mô hình nào trả lời và bạn bị tính phí bao nhiêu. Hướng dẫn này chỉ cách đọc những cái tên này, tại sao cùng một cái tên có thể thay đổi dưới chân bạn, và cần kiểm tra gì trước khi dán một id vào mã.

Cấu trúc của một tên mô hình#

Lấy DeepSeek-V4-Flash-0731 và tách thành các phần:

Hai lưu ý. Hậu tố là một quy ước, không phải luật: 1017 khớp với ngày phát hành của DeepSeek-V4.1-Flash-1017 (17 tháng 10 năm 2026), nhưng hãy luôn xác nhận trên trang của mô hình thay vì đoán. Và một cái tên được viết trên trang tài liệu (DeepSeek-V4-Flash) không phải lúc nào cũng là chuỗi mà API chấp nhận (deepseek-v4-flash-0731): tên hiển thị dành cho con người, id dành cho mã.

Flash và Pro#

Các nhà phát triển thường phát hành nhiều hạng của một thế hệ. Flash thường là hạng nhanh hơn, nhẹ hơn dành cho công việc khối lượng lớn: trò chuyện, trích xuất, vòng lặp tác nhân. Pro thường là hạng lớn hơn cho các tác vụ khó hơn. Các từ này là tiếp thị của chính nhà phát triển, nên chúng không thể so sánh giữa các họ: một Flash từ một công ty không cùng kích thước với một Flash từ công ty khác. Điều quan trọng là deepseek-flash và deepseek-v4-pro là hai tên mô hình khác nhau, vì vậy hãy kiểm tra bảng giá của bất kỳ cái nào bạn dùng. Nếu bạn đổi hạng, hãy kiểm tra lại bảng giá.

Bí danh so với phiên bản ghim#

Có hai loại id, và sự khác biệt là điều quan trọng nhất trong bài viết này.

• Bí danh — một cái tên mà nhà cung cấp trỏ đến một mô hình nào đó và có thể trỏ lại sau này. deepseek-flash là một bí danh: tính đến ngày 22 tháng 10 năm 2026, tài liệu của DeepSeek nói rằng nó được phục vụ bởi DeepSeek-V4.1-Flash-1017, và cách bạn gọi nó không thay đổi. Ngày mai cùng chuỗi đó có thể dẫn đến một bản dựng mới hơn.
• Phiên bản ghim — một id bao gồm bản dựng, chẳng hạn như deepseek-v4-flash-0731. Nó đặt tên cho một bản dựng cụ thể, vì vậy các câu trả lời bạn kiểm tra hôm qua sẽ đến từ cùng bản dựng hôm nay.

Bí danh thì tiện lợi: bạn nhận được cải tiến mà không cần sửa mã. Id ghim thì có thể dự đoán: tốt cho kiểm thử, đánh giá, báo cáo và bất cứ điều gì mà sự thay đổi hành vi sẽ làm bạn bất ngờ. Không cái nào "tốt hơn"; hãy chọn có chủ đích.

Cùng một cái tên có thể thay đổi dưới chân bạn#

Thay đổi của DeepSeek từ tháng 10 năm 2026 là một ví dụ sống. Theo tài liệu của DeepSeek, được kiểm tra vào ngày 22 tháng 10 năm 2026:

• deepseek-flash hiện được phục vụ bởi DeepSeek-V4.1-Flash-1017;
• các tên cũ hơn deepseek-v4-flash và deepseek-v4-flash-vision-exp vẫn được chấp nhận, nhưng những mô hình đó đã ngừng hoạt động, vì vậy các yêu cầu sẽ chuyển đến DeepSeek-V4.1-Flash-1017 và được tính phí theo giá Flash;
• deepseek-v4-pro là một tên mô hình riêng biệt, hiện tại.

Vì vậy mã cũ của bạn có thể vẫn hoạt động và vẫn chạy một mô hình khác với khi bạn viết nó. Điều đó ổn nếu bạn muốn bản mới nhất, và là một cái bẫy nếu bạn so sánh kết quả qua nhiều tuần. Trang tài liệu không có ngày xuất bản, vì vậy hãy coi ánh xạ là đúng cho ngày ở trên và đọc lại khi nó quan trọng. Những gì đã thay đổi trong chính mô hình được đề cập trong DeepSeek-V4.1-Flash-1017 is out.

Cần kiểm tra gì trước khi đặt id vào mã#

1. Sao chép id từ tài liệu của nhà cung cấp mà bạn thực sự gọi. Các nhà cung cấp khác nhau đặt tên cùng một họ khác nhau, vì vậy hãy lấy id từ tài liệu CheapTokens khi bạn gọi CheapTokens, và từ tài liệu DeepSeek khi bạn gọi DeepSeek. Đừng trộn lẫn chúng.
2. Quyết định: bí danh hay ghim? Nếu chuỗi không có hậu tố ngày hoặc bản dựng, hãy giả định nó có thể di chuyển.
3. Kiểm tra URL cơ sở và kiểu API. CheapTokens nói định dạng OpenAI Chat Completions và Anthropic Messages tại https://api.cheaptokens.dev/v1; API riêng của DeepSeek sử dụng https://api.deepseek.com (kiểu OpenAI) và https://api.deepseek.com/anthropic (kiểu Anthropic). Một id đúng trên URL cơ sở sai là một lỗi.
4. Mở bảng giá cho chính xác id đó và ghi lại ngày. Giá thuộc về một mô hình, không phải một họ.
5. Giữ id ở một nơi (tệp cấu hình hoặc biến môi trường) thay vì rải rác trong mã.
6. Ghi log mô hình đã trả lời. Phản hồi kiểu OpenAI có trường model; hãy lưu nó bên cạnh kết quả của bạn.

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)

Hai dòng được in là thói quen đáng xây dựng: những gì bạn yêu cầu và những gì đã trả lời. Không bao giờ mã hóa cứng khóa; xem What is an API key and how to store it safely. Nếu đây là lần gọi đầu tiên của bạn, hãy bắt đầu với Your first API request with CheapTokens.

So sánh giá và kết quả theo từng phiên bản#

Hầu hết sự nhầm lẫn đến từ việc so sánh những thứ sai. Trước khi bạn so sánh hai mức giá hoặc hai câu trả lời, hãy ghi lại cho cả hai bên: id chính xác, nhà cung cấp, và ngày. Hai id đều nói "Flash" nhưng mang thế hệ hoặc hậu tố bản dựng khác nhau là những mô hình khác nhau với ngày phát hành khác nhau. Điều tương tự cũng đúng với điểm chuẩn từ một bài tin tức: chúng thuộc về bản dựng được nêu trong bài và không phải là lời hứa về bất kỳ id nào khác.

Nó cũng hoạt động theo cách ngược lại. Khi bạn kiểm tra một mô hình trên các lời nhắc của riêng bạn, hãy giữ bộ lời nhắc cố định và thay đổi một thứ tại một thời điểm: id, hoặc lời nhắc, không phải cả hai. Đếm token để so sánh? What is a token giải thích cách các con số được đo.

Các id ví dụ để thực hành#

CheapTokens giữ một số dư cho tất cả các mô hình, vì vậy bạn có thể chuyển đổi id với cùng một khóa:

• MiniMax-M2.7 (minimax-m2.7, id cổng MiniMaxAI/MiniMax-M2.7): ngữ cảnh 180K, tối đa 8.192 token đầu ra, một mức giá bất kể giờ nào. Đầu vào $0.05 và đầu ra $0.15 trên 1M token, cả hai đều thấp hơn tham chiếu của OpenRouter.

Bảng dưới đây tính toán lại trực tiếp cho một công việc nhỏ gồm 100.000 token đầu vào và 20.000 token đầu ra, với một cột OpenRouter để tham khảo:

Lưu ý rằng mỗi hàng là một id cụ thể. Nếu bạn hoán đổi minimax-m2.7 sang một id khác, bạn thay đổi cả mô hình và giá.

Tóm tắt nhanh#

• Chuỗi model quyết định mô hình nào trả lời và chi phí bao nhiêu.
• Một id không có hậu tố bản dựng có thể là bí danh và có thể được trỏ lại; một id có bản dựng là ghim.
• Các tên cũ có thể vẫn hoạt động trong khi âm thầm chạy một mô hình mới hơn, như với deepseek-v4-flash trong tài liệu của DeepSeek ngày 22 tháng 10 năm 2026.
• Flash và Pro là các hạng trong một họ, không phải kích thước phổ quát.
• Luôn sao chép id từ tài liệu của nhà cung cấp bạn gọi, và ghi log mô hình đã trả lời.

Sẵn sàng thử? Nhận một khóa, nạp số dư và gửi đoạn mã trên với một id mô hình từ tài liệu CheapTokens.