Liste modelos com GET /v1/models para encontrar o id exato do modelo

Seu código retorna um 404 para um nome de modelo que parecia correto no exemplo de outra pessoa. Pergunte à própria API: uma requisição GET para https://api.cheaptokens.dev/v1/models lista os modelos que você pode chamar, com seus limites de contexto e de saída. Copie o id dessa resposta, não da memória, e verifique o limite antes de definir max_tokens.

A página de documentação (CheapTokens docs, verificada em 28 de outubro de 2026) descreve GET /v1/models como a lista de modelos chamáveis com limites de contexto e de saída. Ao lado dela ficam GET /v1/models/{model} para um modelo e GET /v1/capabilities. O chat em si passa por POST /v1/chat/completions (compatível com OpenAI) ou POST /v1/messages (compatível com Anthropic).

Por que o mesmo modelo tem um id diferente em cada lugar#

Digamos que você encontrou um tutorial de outro provedor. Ele usa model: "deepseek-chat", você cola isso ao lado da base URL da CheapTokens e a requisição falha. Não há nada de errado com sua chave. Os provedores nomeiam o mesmo modelo de formas diferentes: um prefixo como deepseek-ai/, um sufixo de versão como -0731, capitalização diferente. A API aceita apenas a string exata que ela lista, e um nome curto tirado de um rótulo de preço também não vai funcionar.

É exatamente por isso que vale a pena consultar o id uma vez. Se você quiser a história completa de como um id errado aparece na tela, API 401 or 404 error: wrong key, base URL or model id percorre tudo. Este guia é o passo anterior: encontrar o id certo para que você nunca veja esse erro.

Pergunte à API: uma requisição#

Escolha a aba que você usa. Ambas enviam a mesma requisição. Nos dois exemplos a chave vem da variável de ambiente CHEAPTOKENS_API_KEY (a chave está no dashboard assim que houver fundos no saldo).

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

A versão em Python imprime o JSON bruto de propósito. Leia uma vez com seus próprios olhos: você está procurando os ids dos modelos e, ao lado deles, os limites de contexto e de saída. Copie cada id do resultado na íntegra.

Os três ids e seus limites#

A documentação lista estes modelos chamáveis (verificada em 28 de outubro de 2026). Envie a string em formatação de código no início de cada linha como model:

• zai-org/GLM-5.3-Flash — contexto de 390K, até 8.192 tokens de saída.
• deepseek-ai/DeepSeek-V4-Flash-0731 — contexto de 380K, até 32.768 tokens de saída.
• MiniMaxAI/MiniMax-M2.7 — contexto de 180K, até 8.192 tokens de saída.

Dois números importam para a maioria das decisões. Contexto é quanto o modelo consegue comportar em uma requisição, seu prompt e a resposta juntos. Limite de saída é a resposta única mais longa. Se essas palavras são novas, how to read AI model names e why an answer stops mid-sentence explicam em linguagem simples.

Escolha um primeiro modelo para sua tarefa#

Você não precisa de um longo estudo de benchmarks para começar. Duas perguntas resolvem a maioria das primeiras escolhas: qual o tamanho da sua entrada e qual o comprimento necessário da resposta? Clique no caso mais próximo do seu.

Os três compartilham um único saldo e um único preço em qualquer horário do dia, sem horários de pico, então trocar depois custa apenas uma string alterada. Comparado ao OpenRouter, cada um dos três é mais barato no total, com entrada e saída contadas juntas. Veja como é uma carga de trabalho: digamos que você rode um pequeno assistente que envia 2.000 tokens de entrada e recebe 500 de volta, 1.000 vezes por dia. A tabela ao vivo abaixo precifica exatamente isso.

Os preços atuais por token de cada modelo estão na pricing page, e as model pages aprofundam cada um. Se você quiser uma comparação lado a lado por tarefa, há GLM vs DeepSeek vs MiniMax: which model to choose.

Defina max_tokens a partir do limite e envie a requisição#

Um deslize comum: você pede um relatório longo a um modelo cujo limite é 8.192, e a resposta para no meio. O limite que você viu na lista é o teto para max_tokens. Fique igual ou abaixo dele.

Aqui está uma requisição com o id completo da lista. Ela pede uma resposta longa ao modelo que permite isso:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

Novo na primeira chamada? Your first API request with CheapTokens cobre o formato da resposta e o campo usage.

Para fixar a rotina, coloque os passos em ordem:

Se a requisição ainda falhar#

Comece pela string. Um id de modelo que difere em um caractere é a causa usual de um 404, então cole-o novamente da lista em vez de digitá-lo de novo. Um 402 significa que o saldo acabou, e o limite de taxa é de 120 requisições por minuto por chave de API. Os erros voltam no formato JSON padrão da OpenAI/Anthropic, então os SDKs os interpretam como de costume. Para o passo a passo completo, veja API 401 or 404 error.

A API é compatível com OpenAI e Anthropic em https://api.cheaptokens.dev/v1; SDKs da Anthropic e o Claude Code usam a URL raiz https://api.cheaptokens.dev sem /v1. Mais detalhes de configuração estão na docs.