Wie man AI-Modellnamen liest: Alias vs. gepinnte Version

Öffne eine beliebige AI-API-Seite und dir begegnen Namen wie deepseek-flash, deepseek-v4-pro oder DeepSeek-V4-Flash-0731. Sie sehen wie Labels aus, aber der String, den du in das Feld model einträgst, entscheidet welches Modell antwortet und was dir berechnet wird. Dieser Leitfaden zeigt, wie du diese Namen liest, warum sich derselbe Name unter dir ändern kann und was du prüfen solltest, bevor du eine id in Code einfügst.

Anatomie eines Modellnamens#

Nimm DeepSeek-V4-Flash-0731 und zerlege ihn in Teile:

Zwei Warnungen. Der Suffix ist eine Konvention, kein Gesetz: 1017 passt zum Veröffentlichungsdatum von DeepSeek-V4.1-Flash-1017 (17. Oktober 2026), aber bestätige es immer auf der Seite des Modells, statt zu raten. Und ein Name, der auf einer Docs-Seite steht (DeepSeek-V4-Flash), ist nicht immer der String, den die API akzeptiert (deepseek-v4-flash-0731): Der Anzeigename ist für Menschen, die id ist für Code.

Flash und Pro#

Entwickler liefern normalerweise mehrere Tiers einer Generation aus. Flash ist üblicherweise das schnellere, leichtere Tier für Arbeit mit hohem Volumen: Chat, Extraktion, Agent-Loops. Pro ist üblicherweise das größere Tier für schwierigere Aufgaben. Die Wörter sind das Marketing des jeweiligen Entwicklers, daher sind sie zwischen Familien nicht vergleichbar: Ein Flash eines Unternehmens ist nicht gleich groß wie ein Flash eines anderen. Wichtig ist, dass deepseek-flash und deepseek-v4-pro zwei verschiedene Modellnamen sind, also prüfe die Preistabelle desjenigen, das du verwendest. Wenn du das Tier wechselst, prüfe die Preistabelle erneut.

Alias vs. gepinnte Version#

Es gibt zwei Arten von ids, und der Unterschied ist das Wichtigste in diesem Artikel.

• Alias — ein Name, den der Anbieter auf ein Modell zeigt und später umleiten kann. deepseek-flash ist ein Alias: Stand 22. Oktober 2026 wird er laut DeepSeek-Docs von DeepSeek-V4.1-Flash-1017 bedient, und die Art, wie du ihn aufrufst, ist unverändert. Morgen kann derselbe String zu einem neueren Build führen.
• Gepinnte Version — eine id, die den Build enthält, wie deepseek-v4-flash-0731. Sie benennt einen bestimmten Build, also sollten die Antworten, die du gestern getestet hast, heute vom selben Build kommen.

Ein Alias ist praktisch: Du bekommst Verbesserungen, ohne Code zu ändern. Eine gepinnte id ist vorhersehbar: gut für Tests, Evaluierungen, Berichte und alles, wo eine Verhaltensänderung dich überraschen würde. Keines ist „besser“; entscheide dich bewusst.

Derselbe Name kann sich unter dir ändern#

Die DeepSeek-Änderung von Oktober 2026 ist ein aktuelles Beispiel. Laut den DeepSeek-Docs, geprüft am 22. Oktober 2026:

• deepseek-flash wird derzeit von DeepSeek-V4.1-Flash-1017 bedient;
• die älteren Namen deepseek-v4-flash und deepseek-v4-flash-vision-exp werden noch akzeptiert, aber diese Modelle sind eingestellt, also gehen Anfragen an DeepSeek-V4.1-Flash-1017 und werden zum Flash-Preis berechnet;
• deepseek-v4-pro ist ein separater, aktueller Modellname.

Dein alter Code kann also weiter funktionieren und trotzdem ein anderes Modell ausführen als damals, als du ihn geschrieben hast. Das ist in Ordnung, wenn du das Neueste wolltest, und eine Falle, wenn du Ergebnisse über Wochen hinweg verglichen hast. Die Docs-Seite hat kein Veröffentlichungsdatum, also behandle das Mapping als gültig für das obige Datum und lies es erneut, wenn es darauf ankommt. Was sich im Modell selbst geändert hat, steht in DeepSeek-V4.1-Flash-1017 is out.

Was du prüfen solltest, bevor du eine id in Code einfügst#

1. Kopiere die id aus den Docs des Anbieters, den du tatsächlich aufrufst. Verschiedene Anbieter benennen dieselbe Familie unterschiedlich, also nimm die id aus den CheapTokens-Docs, wenn du CheapTokens aufrufst, und aus den DeepSeek-Docs, wenn du DeepSeek aufrufst. Vermische sie nicht.
2. Entscheide: Alias oder gepinnt? Wenn der String kein Datum und keinen Build-Suffix hat, gehe davon aus, dass er sich bewegen kann.
3. Prüfe die Base-URL und den API-Stil. CheapTokens spricht die Formate OpenAI Chat Completions und Anthropic Messages unter https://api.cheaptokens.dev/v1; DeepSeeks eigene API verwendet https://api.deepseek.com (OpenAI-Stil) und https://api.deepseek.com/anthropic (Anthropic-Stil). Eine korrekte id auf der falschen Base-URL ist ein Fehler.
4. Öffne die Preistabelle für genau diese id und notiere das Datum. Preise gehören zu einem Modell, nicht zu einer Familie.
5. Halte die id an einer Stelle (eine Konfigurationsdatei oder eine Umgebungsvariable), statt sie über den Code zu verstreuen.
6. Logge das Modell, das geantwortet hat. Antworten im OpenAI-Stil enthalten ein Feld model; speichere es neben deinen Ergebnissen.

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)

Die beiden ausgegebenen Zeilen sind die Gewohnheit, die es sich zu etablieren lohnt: was du angefragt hast und was geantwortet hat. Hardcode den Key niemals; siehe What is an API key and how to store it safely. Wenn dies dein erster Aufruf ist, beginne mit Your first API request with CheapTokens.

Vergleiche Preise und Ergebnisse Version für Version#

Die meiste Verwirrung entsteht durch den Vergleich der falschen Dinge. Bevor du zwei Preise oder zwei Antworten vergleichst, notiere für beide Seiten: die exakte id, den Anbieter und das Datum. Zwei ids, die beide „Flash“ sagen, aber eine unterschiedliche Generation oder einen unterschiedlichen Build-Suffix tragen, sind verschiedene Modelle mit unterschiedlichen Veröffentlichungsdaten. Dasselbe gilt für Benchmarks aus einem News-Post: Sie gehören zu dem im Post genannten Build und sind kein Versprechen für eine andere id.

Es funktioniert auch andersherum. Wenn du ein Modell mit deinen eigenen Prompts testest, halte das Prompt-Set fest und ändere jeweils nur eine Sache: die id oder den Prompt, nicht beides. Zählst du Tokens für den Vergleich? What is a token erklärt, wie die Zahlen gemessen werden.

Beispiel-ids zum Üben#

CheapTokens führt ein Guthaben für alle Modelle, also kannst du ids mit demselben Key wechseln:

• MiniMax-M2.7 (minimax-m2.7, Gateway-id MiniMaxAI/MiniMax-M2.7): 180K Kontext, bis zu 8.192 Ausgabe-Tokens, ein Preis zu jeder Stunde. Input $0.05 und Output $0.15 pro 1M Tokens, beide unter OpenRouters Referenz.

Die folgende Tabelle berechnet live für einen kleinen Job von 100.000 Input- und 20.000 Output-Tokens, mit einer OpenRouter-Spalte als Referenz:

Beachte, dass jede Zeile eine bestimmte id ist. Wenn du minimax-m2.7 gegen eine andere id tauschst, änderst du sowohl das Modell als auch den Preis.

Kurze Zusammenfassung#

• Der String model entscheidet, welches Modell antwortet und was es kostet.
• Eine id ohne Build-Suffix ist wahrscheinlich ein Alias und kann umgeleitet werden; eine id mit Build ist gepinnt.
• Alte Namen können weiter funktionieren und dabei still ein neueres Modell ausführen, wie bei deepseek-v4-flash in DeepSeeks Docs am 22. Oktober 2026.
• Flash und Pro sind Tiers innerhalb einer Familie, keine universellen Größen.
• Kopiere die id immer aus den Docs des Anbieters, den du aufrufst, und logge, welches Modell geantwortet hat.

Bereit, es auszuprobieren? Hole dir einen Key, lade das Guthaben auf und sende den obigen Snippet mit einer Modell-id aus den CheapTokens-Docs.