Listez les modèles avec GET /v1/models pour trouver l'id exact du modèle

Votre code renvoie une 404 sur un nom de modèle qui semblait correct dans l'exemple de quelqu'un d'autre. Interrogez l'API elle-même : une requête GET vers https://api.cheaptokens.dev/v1/models liste les modèles que vous pouvez appeler, avec leur contexte et leurs limites de sortie. Copiez l'id depuis cette réponse, pas de mémoire, et vérifiez la limite avant de définir max_tokens.

La page de documentation (CheapTokens docs, vérifiée le 28 octobre 2026) décrit GET /v1/models comme la liste des modèles appelables avec leur contexte et leurs limites de sortie. À côté se trouvent GET /v1/models/{model} pour un seul modèle et GET /v1/capabilities. Le chat lui-même passe par POST /v1/chat/completions (compatible OpenAI) ou POST /v1/messages (compatible Anthropic).

Pourquoi le même modèle a un id différent partout#

Supposez que vous ayez trouvé un tutoriel pour un autre fournisseur. Il utilise model: "deepseek-chat", vous le collez à côté de l'URL de base CheapTokens, et la requête échoue. Rien ne cloche avec votre clé. Les fournisseurs nomment le même modèle différemment : un préfixe comme deepseek-ai/, un suffixe de version comme -0731, une capitalisation différente. L'API n'accepte que la chaîne exacte qu'elle liste, et un nom court tiré d'une étiquette de prix ne fonctionnera pas non plus.

C'est toute la raison de chercher l'id une fois. Si vous voulez l'histoire complète de ce à quoi ressemble un mauvais id à l'écran, API 401 or 404 error: wrong key, base URL or model id le détaille. Ce guide est l'étape d'avant : trouver le bon id pour ne jamais voir cette erreur.

Interrogez l'API : une seule requête#

Choisissez l'onglet que vous utilisez. Les deux envoient la même requête. Dans les deux exemples, la clé provient de la variable d'environnement CHEAPTOKENS_API_KEY (la clé se trouve dans le dashboard une fois qu'il y a des fonds sur le solde).

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 version Python affiche le JSON brut exprès. Lisez-le une fois de vos propres yeux : vous cherchez les ids des modèles et, à côté, les limites de contexte et de sortie. Copiez chaque id depuis l'affichage en entier.

Les trois ids et leurs limites#

La documentation liste ces modèles appelables (vérifiée le 28 octobre 2026). Envoyez la chaîne en format code au début de chaque ligne comme model :

• zai-org/GLM-5.3-Flash — contexte de 390K, jusqu'à 8 192 tokens de sortie.
• deepseek-ai/DeepSeek-V4-Flash-0731 — contexte de 380K, jusqu'à 32 768 tokens de sortie.
• MiniMaxAI/MiniMax-M2.7 — contexte de 180K, jusqu'à 8 192 tokens de sortie.

Deux nombres comptent pour la plupart des décisions. Le contexte est ce que le modèle peut contenir dans une requête, votre prompt et sa réponse ensemble. La limite de sortie est la réponse unique la plus longue. Si ces termes sont nouveaux, how to read AI model names et why an answer stops mid-sentence les expliquent en langage simple.

Choisissez un premier modèle pour votre tâche#

Vous n'avez pas besoin d'une longue étude comparative pour commencer. Deux questions règlent la plupart des premiers choix : quelle est la taille de votre entrée, et quelle longueur doit avoir la réponse ? Cliquez sur le cas le plus proche du vôtre.

Les trois partagent un seul solde et un seul prix à toute heure du jour, sans heures de pointe, donc changer plus tard ne coûte qu'une seule chaîne modifiée. Comparés à OpenRouter, chacun des trois est moins cher au total, entrée et sortie comptées ensemble. Voici à quoi ressemble une charge de travail : disons que vous faites tourner un petit assistant qui envoie 2 000 tokens d'entrée et en reçoit 500, 1 000 fois par jour. Le tableau en direct ci-dessous chiffre exactement cela.

Les prix actuels par token pour chaque modèle sont sur la pricing page, et les model pages approfondissent chacun d'eux. Si vous voulez une comparaison côte à côte par tâche, il y a GLM vs DeepSeek vs MiniMax: which model to choose.

Définissez max_tokens à partir de la limite, puis envoyez la requête#

Un oubli courant : vous demandez un long rapport à un modèle dont la limite est de 8 192, et la réponse s'arrête à mi-chemin. La limite que vous avez vue dans la liste est le plafond pour max_tokens. Restez à ce niveau ou en dessous.

Voici une requête avec l'id complet issu de la liste. Elle demande une réponse longue au modèle qui le permet :

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

Nouveau sur le premier appel ? Your first API request with CheapTokens couvre le format de réponse et le champ usage.

Pour ancrer la routine, mettez les étapes dans l'ordre :

Si la requête échoue encore#

Commencez par la chaîne. Un id de modèle qui diffère d'un seul caractère est la cause habituelle d'une 404, donc collez-le à nouveau depuis la liste au lieu de le retaper. Une 402 signifie que le solde est épuisé, et la limite de débit est de 120 requêtes par minute par clé API. Les erreurs reviennent au format JSON standard OpenAI/Anthropic, donc les SDK les analysent comme d'habitude. Pour le parcours complet, voir API 401 or 404 error.

L'API est compatible OpenAI et Anthropic à https://api.cheaptokens.dev/v1 ; les SDK Anthropic et Claude Code utilisent l'URL racine https://api.cheaptokens.dev sans /v1. Plus de détails de configuration se trouvent dans la docs.