AI モデル名の読み方: エイリアス vs 固定バージョン

AI APIのページを開くと、deepseek-flash、deepseek-v4-pro、DeepSeek-V4-Flash-0731 のような名前が目に入ります。これらはラベルのように見えますが、model フィールドに入れる文字列が どのモデルが応答し、いくら請求されるか を決めます。このガイドでは、これらの名前の読み方、同じ名前が知らないうちに変わりうる理由、そしてコードに id を貼り付ける前に確認すべきことを説明します。

モデル名の構造#

DeepSeek-V4-Flash-0731 を例に、部分ごとに分解してみましょう:

注意点が2つあります。サフィックスは慣習であり、規則ではありません: 1017 は DeepSeek-V4.1-Flash-1017（2026年10月17日）のリリース日と一致しますが、推測せず必ずモデルのページで確認してください。また、ドキュメントページに書かれた名前（DeepSeek-V4-Flash）が、API が受け付ける文字列（deepseek-v4-flash-0731）とは限りません。表示名は人間向け、id はコード向けです。

Flash と Pro#

開発者は通常、1つの世代につき複数のティアを提供します。Flash は通常、大量処理向けの高速で軽量なティアです: チャット、抽出、エージェントループなど。Pro は通常、より難しいタスク向けの大きなティアです。これらの言葉は開発者自身のマーケティング用語なので、ファミリー間で比較できるものではありません: ある企業の Flash と別の企業の Flash は同じサイズではありません。重要なのは、deepseek-flash と deepseek-v4-pro は異なるモデル名であるということなので、使う方の価格表を確認してください。ティアを切り替えたら、価格表を再確認しましょう。

エイリアス vs 固定バージョン#

id には2種類あり、その違いがこの記事で最も重要な点です。

• エイリアス — プロバイダーが特定のモデルを指す名前で、後から別のモデルを指すように変更される可能性があります。deepseek-flash はエイリアスです: 2026年10月22日時点で、DeepSeek のドキュメントによると DeepSeek-V4.1-Flash-1017 が提供されており、呼び出し方法は変わりません。明日には同じ文字列が新しいビルドを指す可能性があります。
• 固定バージョン — deepseek-v4-flash-0731 のようにビルドを含む id です。特定のビルドを指すため、昨日テストした回答は今日も同じビルドから得られるはずです。

エイリアスは便利です: コードを編集せずに改善を受けられます。固定 id は予測可能です: テスト、評価、レポート、挙動の変化が予期せぬ結果を招くものに適しています。どちらが「優れている」わけではなく、意図的に選びましょう。

同じ名前が知らないうちに変わりうる#

2026年10月の DeepSeek の変更は実例です。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 のドキュメントから、DeepSeek を呼ぶなら DeepSeek のドキュメントから id を取得してください。混ぜないでください。
2. 決める: エイリアスか固定か? 文字列に日付やビルドサフィックスがなければ、変わりうるものと想定してください。
3. ベース 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 でもベース URL が間違っていればエラーになります。
4. まさにその id の価格表を開き、日付を記録する。価格はファミリーではなくモデルに属します。
5. id を1か所にまとめる（設定ファイルや環境変数）。コード全体に散らばめないでください。
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)

出力される2行は、身につける価値のある習慣です: 何を要求し、何が応答したか。キーをハードコードしないでください; 詳しくは What is an API key and how to store it safely を参照してください。初めての呼び出しなら、Your first API request with CheapTokens から始めましょう。

バージョンごとに価格と結果を比較する#

混乱のほとんどは、間違ったものを比較することから生じます。2つの価格や2つの回答を比較する前に、両方について書き留めてください: 正確な id、プロバイダー、日付。どちらも「Flash」と名乗っていても、世代やビルドサフィックスが異なれば、リリース日の異なる別モデルです。ニュース記事のベンチマークも同様です: それらは記事で名指しされたビルドに属し、他の id についての約束ではありません。

逆もまた然りです。自分のプロンプトでモデルをテストするときは、プロンプトセットを固定し、一度に1つだけ変更してください: id かプロンプトのどちらかで、両方ではありません。比較のためにトークンを数える? What is a token で数値の測定方法を説明しています。

練習用の id の例#

CheapTokens は全モデルで1つの残高を共有するため、同じキーで id を切り替えられます:

• MiniMax-M2.7（minimax-m2.7、ゲートウェイ id MiniMaxAI/MiniMax-M2.7）: 180K コンテキスト、最大 8,192 出力トークン、時間帯を問わず同一価格。入力 $0.05、出力 $0.15（100万トークンあたり）、いずれも OpenRouter の参考価格を下回ります。

以下の表は、入力 100,000 トークン・出力 20,000 トークンの小さなジョブについてライブで再計算され、参考として OpenRouter の列も示しています:

各行は1つの特定の id であることに注意してください。minimax-m2.7 を別の id に置き換えると、モデルと価格の両方が変わります。

簡単なまとめ#

• model 文字列が、どのモデルが応答し、いくらかかるかを決めます。
• ビルドサフィックスのない id はおそらくエイリアスで、別のモデルを指すように変更される可能性があります; ビルド付きの id は固定です。
• 古い名前は動作し続けながら、知らないうちに新しいモデルを実行していることがあります。2026年10月22日の DeepSeek のドキュメントにおける deepseek-v4-flash がその例です。
• Flash と Pro は1つのファミリー内のティアであり、普遍的なサイズではありません。
• 常に呼び出すプロバイダーのドキュメントから id をコピーし、どのモデルが応答したかをログに残しましょう。

試す準備はできましたか? キーを取得し、残高をチャージして、CheapTokens のドキュメントにあるモデル id を使って上記のスニペットを送信してください。