Votre première requête API avec CheapTokens

Ce guide vous mène d'un nouveau compte à une requête fonctionnelle. Il vous faut une adresse e-mail, un petit solde et un terminal. L'API est compatible OpenAI, donc si vous avez déjà appelé OpenAI, seules deux choses changent : l'URL de base et la clé.

Ce qu'il vous faut#

• Un compte. L'inscription se fait par e-mail — pas de mot de passe, nous vous envoyons un lien de connexion.
• Un solde. Il n'y a pas d'abonnement : vous rechargez un solde en USD et chaque requête est facturée au token selon le tarif fixe du modèle.
• Une clé API depuis votre tableau de bord.

Étape 1. Créer un compte et recharger#

Ouvrez la page d'inscription, saisissez votre e-mail et suivez le lien de l'e-mail. Dans le tableau de bord, appuyez sur Recharger et choisissez le mode de paiement :

• Crypto — à partir de 5 $ ; des frais de dépôt de 5 % s'appliquent.
• Carte — via un partenaire, qui facture ses propres frais.

Étape 2. Copier votre clé API#

Dès que votre solde dépasse zéro — après une recharge ou un bonus de parrainage —, le tableau de bord crée votre clé API et l'affiche une seule fois. Copiez-la immédiatement et gardez-la hors de votre code, par exemple dans une variable d'environnement :

export CHEAPTOKENS_API_KEY="paste-your-key-here"

Si la clé fuite, appuyez sur Rotation : vous obtenez une nouvelle clé et l'ancienne cesse de fonctionner.

Étape 3. Choisir un modèle#

Les requêtes nécessitent l'ID complet du modèle — avec le préfixe avant le slash, exactement tel que l'API le liste. Le catalogue au moment de la rédaction (octobre 2026) :

Le catalogue peut changer, donc la source de vérité est l'API elle-même. Cette requête ne nécessite aucune clé :

curl https://api.cheaptokens.dev/v1/models

Étape 4. Envoyer la requête#

curl#

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": "Say hello in three languages"}]
  }'

Une réponse réussie revient au format standard Chat Completions. Un exemple raccourci — votre texte, vos IDs et vos nombres différeront, et la réponse peut contenir des champs de service supplémentaires :

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• Le texte se trouve dans choices[0].message.content.
• L'utilisation des tokens se trouve dans usage : prompt_tokens — entrée, completion_tokens — sortie. Ces deux nombres sont ce pour quoi la requête est facturée.

Python#

Installez le SDK officiel avec pip install openai et pointez-le vers notre URL de base :

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

Installez le SDK avec npm install openai :

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Clients de style Anthropic#

Les clients conçus pour l'API Anthropic Messages utilisent l'adresse racine sans /v1 — https://api.cheaptokens.dev — et envoient la clé dans l'en-tête x-api-key. Les SDK Anthropic ajoutent eux-mêmes le chemin et l'en-tête ; vous ne définissez que l'URL de base et la clé.

Si quelque chose ne va pas#

• 401 Invalid API key — la clé est mal saisie ou a été renouvelée. Vérifiez que vous l'avez collée en entier ; le tableau de bord n'affiche une clé qu'une seule fois, donc si elle est perdue, appuyez sur Rotation pour en obtenir une nouvelle.
• 402 — le solde est épuisé, ou la requête est partie sans l'en-tête Authorization.
• 400 Model "…" not found — utilisez l'ID complet du modèle depuis /v1/models, y compris le préfixe avant le slash.
• 404 — vérifiez l'adresse : les clients de style OpenAI ont besoin de /v1 à la fin de l'URL de base.

Plus de cas et de solutions : Erreurs de connexion courantes et comment les corriger.

Combien ça coûte#

Chaque requête est facturée pour les tokens d'entrée et de sortie séparément, au tarif du modèle par million de tokens. Prix actuels — les mêmes données que sur la page de tarification :

Étape suivante : connecter un agent de codage, par exemple Cline, ou apprendre à estimer ce que coûtera un agent IA.

Vous recommandez CheapTokens à d'autres développeurs ? Le programme de parrainage vous crédite un pourcentage de leurs recharges.