Como ler nomes de modelos de IA: alias vs versão fixada

Abra qualquer página de API de IA e você encontra nomes como deepseek-flash, deepseek-v4-pro ou DeepSeek-V4-Flash-0731. Eles parecem rótulos, mas a string que você coloca no campo model decide qual modelo responde e quanto você paga. Este guia mostra como ler esses nomes, por que o mesmo nome pode mudar debaixo do seu nariz e o que verificar antes de colar um id no código.

Anatomia de um nome de modelo#

Pegue DeepSeek-V4-Flash-0731 e divida em partes:

Dois cuidados. O sufixo é uma convenção, não uma lei: 1017 bate com a data de lançamento do DeepSeek-V4.1-Flash-1017 (17 de outubro de 2026), mas sempre confirme na página do modelo em vez de adivinhar. E um nome escrito numa página de docs (DeepSeek-V4-Flash) nem sempre é a string que a API aceita (deepseek-v4-flash-0731): o nome de exibição é para pessoas, o id é para código.

Flash e Pro#

Os desenvolvedores costumam lançar vários níveis de uma mesma geração. Flash normalmente é o nível mais rápido e leve, voltado para trabalho de alto volume: chat, extração, loops de agente. Pro normalmente é o nível maior, para tarefas mais difíceis. As palavras são marketing do próprio desenvolvedor, então não são comparáveis entre famílias: um Flash de uma empresa não tem o mesmo tamanho que um Flash de outra. O que importa é que deepseek-flash e deepseek-v4-pro são dois nomes de modelo diferentes, então confira a tabela de preços do que você usar. Se trocar o nível, confira a tabela de preços de novo.

Alias vs versão fixada#

Existem dois tipos de id, e a diferença é a coisa mais importante deste artigo.

• Alias — um nome que o provedor aponta para algum modelo e pode reapontar depois. deepseek-flash é um alias: em 22 de outubro de 2026, os docs da DeepSeek dizem que ele é servido pelo DeepSeek-V4.1-Flash-1017, e a forma de chamá-lo não mudou. Amanhã a mesma string pode levar a um build mais novo.
• Versão fixada — um id que inclui o build, como deepseek-v4-flash-0731. Ele nomeia um build específico, então as respostas que você testou ontem devem vir do mesmo build hoje.

Um alias é conveniente: você recebe melhorias sem editar código. Um id fixado é previsível: bom para testes, avaliações, relatórios e qualquer coisa em que uma mudança de comportamento te surpreenderia. Nenhum é "melhor"; escolha de propósito.

O mesmo nome pode mudar debaixo do seu nariz#

A mudança da DeepSeek de outubro de 2026 é um exemplo vivo. Segundo os docs da DeepSeek, verificados em 22 de outubro de 2026:

• deepseek-flash atualmente é servido pelo DeepSeek-V4.1-Flash-1017;
• os nomes antigos deepseek-v4-flash e deepseek-v4-flash-vision-exp ainda são aceitos, mas esses modelos foram aposentados, então as requisições vão para o DeepSeek-V4.1-Flash-1017 e são cobradas pelo preço do Flash;
• deepseek-v4-pro é um nome de modelo separado e atual.

Então seu código antigo pode continuar funcionando e ainda assim rodar um modelo diferente do que quando você o escreveu. Isso é ótimo se você queria o mais recente, e uma armadilha se você comparou resultados ao longo de semanas. A página de docs não tem data de publicação, então trate o mapeamento como válido para a data acima e releia quando importar. O que mudou no modelo em si está em DeepSeek-V4.1-Flash-1017 is out.

O que verificar antes de colocar um id no código#

1. Copie o id dos docs do provedor que você realmente chama. Provedores diferentes nomeiam a mesma família de formas diferentes, então pegue o id dos docs da CheapTokens quando chamar a CheapTokens, e dos docs da DeepSeek quando chamar a DeepSeek. Não misture.
2. Decida: alias ou fixado? Se a string não tem data nem sufixo de build, assuma que ela pode mudar.
3. Confira a base URL e o estilo de API. A CheapTokens fala os formatos OpenAI Chat Completions e Anthropic Messages em https://api.cheaptokens.dev/v1; a API própria da DeepSeek usa https://api.deepseek.com (estilo OpenAI) e https://api.deepseek.com/anthropic (estilo Anthropic). Um id correto na base URL errada é um erro.
4. Abra a tabela de preços exatamente desse id e anote a data. Preços pertencem a um modelo, não a uma família.
5. Mantenha o id em um só lugar (um arquivo de config ou uma variável de ambiente) em vez de espalhado pelo código.
6. Registre o modelo que respondeu. Respostas no estilo OpenAI trazem um campo model; salve-o junto com seus 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)

As duas linhas impressas são o hábito que vale a pena criar: o que você pediu e o que respondeu. Nunca deixe a chave hard-coded; veja What is an API key and how to store it safely. Se esta é sua primeira chamada, comece por Your first API request with CheapTokens.

Compare preços e resultados versão a versão#

A maior parte da confusão vem de comparar as coisas erradas. Antes de comparar dois preços ou duas respostas, anote dos dois lados: o id exato, o provedor e a data. Dois ids que dizem "Flash" mas têm geração ou sufixo de build diferentes são modelos diferentes com datas de lançamento diferentes. O mesmo vale para benchmarks de uma notícia: eles pertencem ao build citado na notícia e não são promessa sobre nenhum outro id.

Também funciona ao contrário. Quando você testa um modelo com seus próprios prompts, mantenha o conjunto de prompts fixo e mude uma coisa por vez: o id ou o prompt, não os dois. Contando tokens para a comparação? What is a token explica como os números são medidos.

Ids de exemplo para praticar#

A CheapTokens mantém um único saldo para todos os modelos, então você pode trocar de id com a mesma chave:

• MiniMax-M2.7 (minimax-m2.7, id no gateway MiniMaxAI/MiniMax-M2.7): contexto de 180K, até 8.192 tokens de saída, um preço a qualquer hora. Entrada $0.05 e saída $0.15 por 1M de tokens, ambos abaixo da referência do OpenRouter.

A tabela abaixo recalcula ao vivo para um trabalho pequeno de 100.000 tokens de entrada e 20.000 de saída, com uma coluna do OpenRouter para referência:

Observe que cada linha é um id específico. Se você trocar minimax-m2.7 por outro id, muda tanto o modelo quanto o preço.

Resumo rápido#

• A string model decide qual modelo responde e quanto custa.
• Um id sem sufixo de build provavelmente é um alias e pode ser reapontado; um id com build é fixado.
• Nomes antigos podem continuar funcionando enquanto rodam silenciosamente um modelo mais novo, como com deepseek-v4-flash nos docs da DeepSeek em 22 de outubro de 2026.
• Flash e Pro são níveis dentro de uma família, não tamanhos universais.
• Sempre copie o id dos docs do provedor que você chama, e registre qual modelo respondeu.

Pronto para testar? Pegue uma chave, recarregue o saldo e envie o trecho acima com um id de modelo dos docs da CheapTokens.