Comment lire les noms de modèles IA : alias vs version épinglée

Ouvrez n'importe quelle page d'API IA et vous croisez des noms comme deepseek-flash, deepseek-v4-pro ou DeepSeek-V4-Flash-0731. Ils ressemblent à des étiquettes, mais la chaîne que vous placez dans le champ model décide quel modèle répond et ce qui vous est facturé. Ce guide montre comment lire ces noms, pourquoi un même nom peut changer sous vos pieds, et ce qu'il faut vérifier avant de coller un id dans du code.

Anatomie d'un nom de modèle#

Prenez DeepSeek-V4-Flash-0731 et découpez-le en parties :

Deux mises en garde. Le suffixe est une convention, pas une loi : 1017 correspond à la date de sortie de DeepSeek-V4.1-Flash-1017 (17 octobre 2026), mais confirmez-le toujours sur la page du modèle au lieu de deviner. Et un nom écrit dans une page de docs (DeepSeek-V4-Flash) n'est pas toujours la chaîne acceptée par l'API (deepseek-v4-flash-0731) : le nom d'affichage est pour les humains, l'id est pour le code.

Flash et Pro#

Les développeurs publient généralement plusieurs niveaux d'une même génération. Flash est normalement le niveau plus rapide et plus léger, destiné aux gros volumes : chat, extraction, boucles d'agents. Pro est normalement le niveau plus grand pour les tâches difficiles. Ces mots relèvent du marketing du développeur, ils ne sont donc pas comparables entre familles : un Flash d'une entreprise n'a pas la même taille qu'un Flash d'une autre. Ce qui compte, c'est que deepseek-flash et deepseek-v4-pro sont deux noms de modèles différents, alors vérifiez la table de prix de celui que vous utilisez. Si vous changez de niveau, revérifiez la table de prix.

Alias vs version épinglée#

Il existe deux types d'ids, et la différence est la chose la plus importante de cet article.

• Alias — un nom que le fournisseur pointe vers un modèle et peut repointer plus tard. deepseek-flash est un alias : au 22 octobre 2026, les docs de DeepSeek indiquent qu'il est servi par DeepSeek-V4.1-Flash-1017, et votre façon de l'appeler reste inchangée. Demain, la même chaîne peut mener à un build plus récent.
• Version épinglée — un id qui inclut le build, comme deepseek-v4-flash-0731. Il désigne un build précis, donc les réponses que vous avez testées hier devraient venir du même build aujourd'hui.

Un alias est pratique : vous profitez des améliorations sans modifier le code. Un id épinglé est prévisible : idéal pour les tests, les évaluations, les rapports et tout ce où un changement de comportement vous surprendrait. Aucun n'est « meilleur » ; choisissez en connaissance de cause.

Le même nom peut changer sous vos pieds#

Le changement DeepSeek d'octobre 2026 en est un exemple concret. D'après les docs DeepSeek, vérifiées le 22 octobre 2026 :

• deepseek-flash est actuellement servi par DeepSeek-V4.1-Flash-1017 ;
• les anciens noms deepseek-v4-flash et deepseek-v4-flash-vision-exp sont toujours acceptés, mais ces modèles sont retirés, donc les requêtes vont vers DeepSeek-V4.1-Flash-1017 et sont facturées au prix Flash ;
• deepseek-v4-pro est un nom de modèle distinct et actuel.

Ainsi, votre ancien code peut continuer à fonctionner tout en exécutant un modèle différent de celui de l'époque où vous l'avez écrit. C'est parfait si vous vouliez le dernier, et un piège si vous comparez des résultats sur plusieurs semaines. La page de docs n'a pas de date de publication, alors considérez ce mapping comme valable à la date ci-dessus et relisez-le quand cela compte. Ce qui a changé dans le modèle lui-même est traité dans DeepSeek-V4.1-Flash-1017 is out.

Ce qu'il faut vérifier avant de mettre un id dans du code#

1. Copiez l'id depuis les docs du fournisseur que vous appelez réellement. Différents fournisseurs nomment différemment la même famille, alors prenez l'id dans les docs CheapTokens quand vous appelez CheapTokens, et dans les docs DeepSeek quand vous appelez DeepSeek. Ne les mélangez pas.
2. Décidez : alias ou épinglé ? Si la chaîne n'a ni date ni suffixe de build, supposez qu'elle peut bouger.
3. Vérifiez l'URL de base et le style d'API. CheapTokens parle les formats OpenAI Chat Completions et Anthropic Messages à https://api.cheaptokens.dev/v1 ; l'API propre à DeepSeek utilise https://api.deepseek.com (style OpenAI) et https://api.deepseek.com/anthropic (style Anthropic). Un id correct sur une mauvaise URL de base est une erreur.
4. Ouvrez la table de prix pour exactement cet id et notez la date. Les prix appartiennent à un modèle, pas à une famille.
5. Gardez l'id à un seul endroit (un fichier de config ou une variable d'environnement) plutôt que dispersé dans le code.
6. Journalisez le modèle qui a répondu. Les réponses de style OpenAI portent un champ model ; enregistrez-le à côté de vos résultats.

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)

Les deux lignes affichées sont l'habitude à adopter : ce que vous avez demandé et ce qui a répondu. Ne codez jamais la clé en dur ; voir What is an API key and how to store it safely. Si c'est votre premier appel, commencez par Your first API request with CheapTokens.

Comparez prix et résultats version par version#

La plupart des confusions viennent de comparer les mauvaises choses. Avant de comparer deux prix ou deux réponses, notez pour les deux côtés : l'id exact, le fournisseur et la date. Deux ids qui disent tous deux « Flash » mais portent une génération ou un suffixe de build différent sont des modèles différents avec des dates de sortie différentes. Il en va de même pour les benchmarks d'un article de presse : ils appartiennent au build nommé dans l'article et ne constituent pas une promesse pour un autre id.

Cela marche aussi dans l'autre sens. Quand vous testez un modèle sur vos propres prompts, gardez le jeu de prompts fixe et changez une seule chose à la fois : l'id, ou le prompt, pas les deux. Vous comptez les tokens pour la comparaison ? What is a token explique comment les nombres sont mesurés.

Exemples d'ids pour s'entraîner#

CheapTokens garde un seul solde pour tous les modèles, vous pouvez donc changer d'id avec la même clé :

• MiniMax-M2.7 (minimax-m2.7, id de passerelle MiniMaxAI/MiniMax-M2.7) : contexte de 180K, jusqu'à 8 192 tokens de sortie, un seul prix à toute heure. Entrée $0.05 et sortie $0.15 par 1M de tokens, tous deux inférieurs à la référence OpenRouter.

Le tableau ci-dessous se recalcule en direct pour une petite tâche de 100 000 tokens d'entrée et 20 000 tokens de sortie, avec une colonne OpenRouter pour référence :

Notez que chaque ligne correspond à un id précis. Si vous remplacez minimax-m2.7 par un autre id, vous changez à la fois le modèle et le prix.

Récapitulatif rapide#

• La chaîne model décide quel modèle répond et ce qu'il coûte.
• Un id sans suffixe de build est probablement un alias et peut être repointé ; un id avec un build est épinglé.
• Les anciens noms peuvent continuer à fonctionner tout en exécutant discrètement un modèle plus récent, comme avec deepseek-v4-flash dans les docs DeepSeek du 22 octobre 2026.
• Flash et Pro sont des niveaux au sein d'une famille, pas des tailles universelles.
• Copiez toujours l'id depuis les docs du fournisseur que vous appelez, et journalisez quel modèle a répondu.

Prêt à essayer ? Obtenez une clé, rechargez le solde et envoyez l'extrait ci-dessus avec un id de modèle tiré des docs CheapTokens.