Cómo leer los nombres de modelos de IA: alias vs versión fijada

Abre cualquier página de API de IA y te encuentras con nombres como deepseek-flash, deepseek-v4-pro o DeepSeek-V4-Flash-0731. Parecen etiquetas, pero la cadena que pones en el campo model decide qué modelo responde y qué se te factura. Esta guía muestra cómo leer estos nombres, por qué el mismo nombre puede cambiar bajo tus pies y qué comprobar antes de pegar un id en el código.

Anatomía de un nombre de modelo#

Toma DeepSeek-V4-Flash-0731 y divídelo en partes:

Dos advertencias. El sufijo es una convención, no una ley: 1017 encaja con la fecha de lanzamiento de DeepSeek-V4.1-Flash-1017 (17 de octubre de 2026), pero confírmalo siempre en la página del modelo en lugar de adivinarlo. Y un nombre escrito en una página de documentación (DeepSeek-V4-Flash) no siempre es la cadena que acepta la API (deepseek-v4-flash-0731): el nombre visible es para las personas, el id es para el código.

Flash y Pro#

Los desarrolladores suelen lanzar varios niveles de una generación. Flash es normalmente el nivel más rápido y ligero, pensado para trabajo de alto volumen: chat, extracción, bucles de agentes. Pro es normalmente el nivel más grande para tareas más difíciles. Las palabras son marketing propio del desarrollador, así que no son comparables entre familias: un Flash de una empresa no es del mismo tamaño que un Flash de otra. Lo que importa es que deepseek-flash y deepseek-v4-pro son dos nombres de modelo diferentes, así que consulta la tabla de precios del que uses. Si cambias de nivel, vuelve a consultar la tabla de precios.

Alias vs versión fijada#

Hay dos tipos de ids, y la diferencia es lo más importante de este artículo.

• Alias — un nombre que el proveedor apunta a algún modelo y puede re-apuntar más adelante. deepseek-flash es un alias: a fecha de 22 de octubre de 2026, la documentación de DeepSeek dice que lo sirve DeepSeek-V4.1-Flash-1017, y la forma de llamarlo no ha cambiado. Mañana la misma cadena puede llevar a una compilación más nueva.
• Versión fijada — un id que incluye la compilación, como deepseek-v4-flash-0731. Nombra una compilación específica, así que las respuestas que probaste ayer deberían venir de la misma compilación hoy.

Un alias es cómodo: obtienes mejoras sin editar código. Un id fijado es predecible: bueno para pruebas, evaluaciones, informes y cualquier cosa donde un cambio de comportamiento te sorprendería. Ninguno es "mejor"; elige a propósito.

El mismo nombre puede cambiar bajo tus pies#

El cambio de DeepSeek de octubre de 2026 es un ejemplo en vivo. Según la documentación de DeepSeek, consultada el 22 de octubre de 2026:

• deepseek-flash actualmente lo sirve DeepSeek-V4.1-Flash-1017;
• los nombres antiguos deepseek-v4-flash y deepseek-v4-flash-vision-exp todavía se aceptan, pero esos modelos están retirados, así que las peticiones van a DeepSeek-V4.1-Flash-1017 y se facturan al precio de Flash;
• deepseek-v4-pro es un nombre de modelo separado y actual.

Así que tu código antiguo puede seguir funcionando y aun así ejecutar un modelo diferente al de cuando lo escribiste. Eso está bien si querías lo último, y es una trampa si comparaste resultados entre semanas. La página de documentación no tiene fecha de publicación, así que trata la asignación como válida para la fecha anterior y vuelve a leerla cuando importe. Lo que cambió en el modelo en sí se cubre en DeepSeek-V4.1-Flash-1017 is out.

Qué comprobar antes de poner un id en el código#

1. Copia el id de la documentación del proveedor al que realmente llamas. Diferentes proveedores nombran la misma familia de forma distinta, así que toma el id de la documentación de CheapTokens cuando llames a CheapTokens, y de la de DeepSeek cuando llames a DeepSeek. No los mezcles.
2. Decide: ¿alias o fijado? Si la cadena no tiene fecha ni sufijo de compilación, asume que puede moverse.
3. Comprueba la URL base y el estilo de API. CheapTokens habla los formatos OpenAI Chat Completions y Anthropic Messages en https://api.cheaptokens.dev/v1; la propia API de DeepSeek usa https://api.deepseek.com (estilo OpenAI) y https://api.deepseek.com/anthropic (estilo Anthropic). Un id correcto en la URL base equivocada es un error.
4. Abre la tabla de precios para exactamente ese id y anota la fecha. Los precios pertenecen a un modelo, no a una familia.
5. Mantén el id en un solo lugar (un archivo de configuración o una variable de entorno) en lugar de dispersarlo por el código.
6. Registra el modelo que respondió. Las respuestas estilo OpenAI llevan un campo model; guárdalo junto a tus resultados.

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)

Las dos líneas impresas son el hábito que vale la pena construir: lo que pediste y lo que respondió. Nunca codifiques la clave directamente; consulta What is an API key and how to store it safely. Si es tu primera llamada, empieza con Your first API request with CheapTokens.

Compara precios y resultados versión a versión#

La mayor parte de la confusión viene de comparar cosas equivocadas. Antes de comparar dos precios o dos respuestas, anota para ambos lados: el id exacto, el proveedor y la fecha. Dos ids que ambos dicen "Flash" pero llevan una generación o sufijo de compilación diferente son modelos distintos con fechas de lanzamiento distintas. Lo mismo ocurre con los benchmarks de una nota de prensa: pertenecen a la compilación nombrada en la nota y no son una promesa sobre ningún otro id.

También funciona al revés. Cuando pruebes un modelo con tus propios prompts, mantén el conjunto de prompts fijo y cambia una cosa a la vez: el id o el prompt, no ambos. ¿Contando tokens para la comparación? What is a token explica cómo se miden los números.

Ids de ejemplo para practicar#

CheapTokens mantiene un solo saldo para todos los modelos, así que puedes cambiar de id con la misma clave:

• MiniMax-M2.7 (minimax-m2.7, id de pasarela MiniMaxAI/MiniMax-M2.7): contexto de 180K, hasta 8.192 tokens de salida, un precio a cualquier hora. Entrada $0.05 y salida $0.15 por 1M de tokens, ambas por debajo de la referencia de OpenRouter.

La tabla siguiente se recalcula en vivo para un trabajo pequeño de 100.000 tokens de entrada y 20.000 de salida, con una columna de OpenRouter como referencia:

Ten en cuenta que cada fila es un id específico. Si cambias minimax-m2.7 por otro id, cambias tanto el modelo como el precio.

Resumen rápido#

• La cadena model decide qué modelo responde y cuánto cuesta.
• Un id sin sufijo de compilación es probablemente un alias y puede re-apuntarse; un id con compilación está fijado.
• Los nombres antiguos pueden seguir funcionando mientras ejecutan silenciosamente un modelo más nuevo, como con deepseek-v4-flash en la documentación de DeepSeek el 22 de octubre de 2026.
• Flash y Pro son niveles dentro de una familia, no tamaños universales.
• Copia siempre el id de la documentación del proveedor al que llamas, y registra qué modelo respondió.

¿Listo para probarlo? Obtén una clave, recarga el saldo y envía el fragmento de arriba con un id de modelo de la documentación de CheapTokens.