Lista modelos con GET /v1/models para encontrar el id exacto del modelo

Tu código devuelve un 404 con un nombre de modelo que parecía correcto en el ejemplo de otra persona. Pregúntale a la propia API: una petición GET a https://api.cheaptokens.dev/v1/models lista los modelos que puedes llamar, con su contexto y sus límites de salida. Copia el id de esa respuesta, no de memoria, y comprueba el límite antes de fijar max_tokens.

La página de documentación (CheapTokens docs, consultada el 28 de octubre de 2026) describe GET /v1/models como la lista de modelos invocables con contexto y límites de salida. Junto a ella están GET /v1/models/{model} para un solo modelo y GET /v1/capabilities. El chat en sí pasa por POST /v1/chat/completions (compatible con OpenAI) o POST /v1/messages (compatible con Anthropic).

Por qué el mismo modelo tiene un id distinto en cada sitio#

Supongamos que encontraste un tutorial para otro proveedor. Usa model: "deepseek-chat", lo pegas junto a la URL base de CheapTokens y la petición falla. No hay nada malo con tu clave. Los proveedores nombran el mismo modelo de forma distinta: un prefijo como deepseek-ai/, un sufijo de versión como -0731, mayúsculas y minúsculas diferentes. La API solo acepta la cadena exacta que lista, y un nombre corto tomado de una etiqueta de precio tampoco funcionará.

Esa es la razón principal para buscar el id una vez. Si quieres la historia completa de cómo se ve un id incorrecto en pantalla, API 401 or 404 error: wrong key, base URL or model id lo recorre paso a paso. Esta guía es el paso anterior: encontrar el id correcto para que nunca veas ese error.

Pregúntale a la API: una petición#

Elige la pestaña que uses. Ambas envían la misma petición. En los dos ejemplos la clave viene de la variable de entorno CHEAPTOKENS_API_KEY (la clave está en el dashboard una vez que hay fondos en el 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))

La versión de Python imprime el JSON en bruto a propósito. Léelo una vez con tus propios ojos: buscas los ids de los modelos y, junto a ellos, los límites de contexto y de salida. Copia cada id del resultado en su totalidad.

Los tres ids y sus límites#

La documentación lista estos modelos invocables (consultada el 28 de octubre de 2026). Envía la cadena en formato de código al principio de cada línea como model:

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

Dos números importan para la mayoría de las decisiones. El contexto es cuánto puede contener el modelo en una petición, tu prompt y su respuesta juntos. El límite de salida es la respuesta única más larga. Si estas palabras son nuevas, how to read AI model names y why an answer stops mid-sentence las explican en lenguaje sencillo.

Elige un primer modelo para tu tarea#

No necesitas un largo estudio de benchmarks para empezar. Dos preguntas resuelven la mayoría de las primeras elecciones: ¿qué tamaño tiene tu entrada y qué longitud debe tener la respuesta? Haz clic en el caso más parecido al tuyo.

Los tres comparten un mismo saldo y un mismo precio a cualquier hora del día, sin horas punta, así que cambiar más adelante solo te cuesta una cadena modificada. Comparado con OpenRouter, cada uno de los tres es más barato en total, contando entrada y salida juntas. Así se ve una carga de trabajo: supongamos que ejecutas un pequeño asistente que envía 2.000 tokens de entrada y recibe 500, 1.000 veces al día. La tabla en vivo de abajo calcula exactamente eso.

Los precios actuales por token de cada modelo están en la pricing page, y las model pages profundizan en cada uno. Si quieres una comparación lado a lado por tarea, tienes GLM vs DeepSeek vs MiniMax: which model to choose.

Fija max_tokens a partir del límite y luego envía la petición#

Un desliz habitual: pides un informe largo a un modelo cuyo límite es 8.192 y la respuesta se corta a mitad. El límite que viste en la lista es el techo para max_tokens. Mantente en él o por debajo.

Aquí tienes una petición con el id completo de la lista. Pide una respuesta larga al modelo que lo permite:

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
  }'

¿Es tu primera llamada? Your first API request with CheapTokens cubre el formato de la respuesta y el campo usage.

Para afianzar la rutina, pon los pasos en orden:

Si la petición sigue fallando#

Empieza por la cadena. Un id de modelo que difiere en un solo carácter es la causa habitual de un 404, así que vuelve a pegarlo desde la lista en lugar de reescribirlo. Un 402 significa que el saldo está agotado, y el límite de peticiones es de 120 por minuto por clave de API. Los errores vuelven con la forma JSON estándar de OpenAI/Anthropic, así que los SDK los analizan como de costumbre. Para el recorrido completo, consulta API 401 or 404 error.

La API es compatible con OpenAI y Anthropic en https://api.cheaptokens.dev/v1; los SDK de Anthropic y Claude Code usan la URL raíz https://api.cheaptokens.dev sin /v1. Más detalles de configuración están en la docs.