Documentation

Connectez votre outil en une minute.

Tous les outils ont besoin des deux mêmes choses : l'URL de base ci-dessous et votre clé. Choisissez votre outil et suivez les étapes.

URL de base · la même pour tous les outilshttps://api.tokenlowcost.com/v1
Clé API · une clé par modèlesk-tlc-…

Démarrage rapide

Environ une minute
  1. Créer une clé

    Dans le tableau de bord, choisissez un modèle et cliquez sur Créer une clé. Copiez la clé tout de suite : elle ne s'affiche qu'une fois.

  2. Configurez votre outil

    Trouvez votre outil ci-dessous. Juste après la création d'une clé, le tableau de bord affiche les mêmes étapes avec votre clé déjà renseignée.

  3. Au travail

    Utilisez votre outil comme d'habitude. Chaque requête est payée sur votre solde, et le tableau de bord l'affiche avec son coût.

Modèles

Classés, les meilleurs d'abord

Chaque clé fonctionne avec un seul modèle : celui que vous choisissez à sa création. Ce modèle répond à toutes les requêtes faites avec la clé, quel que soit le nom de modèle envoyé par votre outil. Vous voulez deux modèles ? Créez deux clés.

Pour la même raison, GET /v1/models ne liste que le modèle de votre clé. Les outils qui affichent une liste de modèles, comme Cline et Roo Code, ne proposent que celui-là.

Tous les modèles et leurs prix sont sur la page des tarifs.

Facturation et limites

Prépayé · au token

Vous approvisionnez d'abord votre solde. Les nouveaux comptes démarrent avec $50 de crédit de bienvenue, un par personne. Chaque requête coûte ses tokens au prix de votre modèle, et ce montant est débité du solde. Le tableau de bord liste chaque requête avec ses tokens et son coût.

Le texte répété coûte moins cher. Quand le modèle a vu récemment le début d'un prompt, ces tokens sont facturés au tarif cache, moins cher. Les outils de code envoient le même contexte encore et encore : l'économie est importante.

Quand les requêtes s'arrêtent

Ce qui s'est passéRésultat
Limite de la clé atteinte402 pour cette clé. Vos autres clés continuent de fonctionner.
Clé expirée403 pour cette clé.
Clé révoquée401 immédiatement. C'est irréversible.
Solde à $0402 pour toutes les clés jusqu'à la recharge. Le solde ne passe jamais sous zéro.
Compte banni403 pour toutes les clés, et vous ne pouvez plus vous connecter. Les bannissements sanctionnent les infractions aux règles.

Contexte et effort

Facultatif, par clé

À la création d'une clé, vous pouvez aussi choisir ces deux réglages. La boîte de dialogue indique le coût de l'entrée d'un prompt qui remplit la fenêtre choisie.

RéglageEffet
Fenêtre de contexteLa quantité de texte qu'une requête peut contenir, de 128K tokens jusqu'au maximum du modèle. C'est une limite de la clé : le modèle lui-même ne change pas. Les requêtes au-delà sont refusées et ne coûtent rien. La taille est estimée, elle peut donc varier de quelques pour cent.
EffortÀ quel point le modèle réfléchit avant de répondre. Avec Selon l'app, c'est votre outil qui décide. Un niveau fixe s'applique à toutes les requêtes faites avec la clé. Plus de réflexion signifie plus de tokens de sortie, donc un coût plus élevé.

Les étapes de configuration du tableau de bord transmettent ces deux réglages à votre outil.

Les longues conversations coûtent plus cher. Les outils de code envoient toute la conversation à chaque étape, donc chaque étape coûte un peu plus que la précédente, jusqu'à ce que l'outil raccourcisse la conversation. Avec une fenêtre de contexte plus petite, cela arrive plus tôt. Certains modèles facturent aussi plus cher les prompts très longs ; la page des tarifs indique à partir d'où.
Cu

Cursor

Settings → Models
  1. Ouvrez les paramètres

    Dans Cursor, ouvrez Settings → Models et descendez jusqu'à API Keys.

  2. Collez votre clé et l'URL de base

    Collez votre clé dans OpenAI API Key. Activez Override OpenAI Base URL et collez l'URL de base.

    OpenAI API Key            sk-tlc-your-key
    Override OpenAI Base URL  on
    Base URL                  https://api.tokenlowcost.com/v1
  3. Ajoutez un nom de modèle

    Cliquez sur + Add model, tapez un nom comme tlc-opus et activez-le. Le nom n'est qu'une étiquette : c'est votre clé qui détermine le modèle. Choisissez un nom que Cursor n'a pas déjà, pour que la requête parte avec votre clé.

  4. Vérifiez et discutez

    Cliquez sur Verify à côté de la clé. Puis choisissez votre modèle dans le chat.

VS

VS Code

Chat intégré · sans extension ni compte GitHub

Le chat intégré à VS Code peut utiliser votre clé. Il faut VS Code 1.122 ou plus récent. Si VS Code vous demande de vous connecter au premier lancement, cliquez sur Continue without Signing In.

  1. Ajoutez un endpoint personnalisé

    Appuyez sur Ctrl + Maj + P (Cmd sur Mac) et lancez Chat: Manage Language Models. Cliquez sur Add Models, puis sur Custom Endpoint.

  2. Saisissez un nom et votre clé

    Nommez-le TokenLowCost et collez votre clé. À l'étape API Type, appuyez simplement sur Entrée.

  3. Collez votre modèle

    VS Code ouvre un fichier contenant un modèle vide. Remplacez sa partie "models": [ … ] par le bloc ci-dessous et enregistrez. Le tableau de bord vous donne ce bloc tout prêt pour votre clé, juste après sa création. Vous copiez d'ici ? Prenez le bloc Claude pour les modèles Claude, l'autre pour les autres, et remplacez id et name par ceux de votre modèle.

    
                  
    
                
  4. Choisissez le modèle

    Ouvrez le chat, cliquez sur le nom du modèle dans la zone de saisie et choisissez votre modèle.

VS Code conserve votre clé dans son stockage sécurisé, pas dans le fichier. Le chat fonctionne entièrement, mode agent compris. Les suggestions grises qui apparaissent pendant la saisie ne sont pas concernées : elles viennent uniquement de GitHub Copilot.

Pas de connexion à GitHub ? VS Code affiche alors Set BYOK utility models. Cliquez sur Configure et choisissez Main Agent Model, pour que les titres de chat et les messages de commit utilisent aussi votre modèle. Ce sont de petites requêtes, facturées comme les autres.

Claude Code ou Codex dans VS Code

Les extensions Claude Code et Codex utilisent les mêmes réglages que leurs versions terminal. Collez d'abord la ligne Claude Code ou Codex, puis installez l'extension et redémarrez VS Code. Pour Claude Code, ouvrez aussi Settings, cherchez Claude Code login et cochez Disable Login Prompt.

CC

Claude Code

Une ligne à coller

Une ligne enregistre l'URL de base, votre clé et le modèle de votre clé, et chaque nouveau terminal les reprend. La ligne ci-dessous est pour une clé Claude Opus 5.5 et contient une clé factice. Le tableau de bord l'affiche adaptée à votre clé : son modèle, sa fenêtre de contexte et son effort.


          

        
  1. Collez la ligne

    Collez-la dans PowerShell (Windows) ou Terminal (macOS, Linux) et appuyez sur Entrée.

  2. Lancez Claude Code

    Lancez claude dans la même fenêtre. La première fois, appuyez sur Entrée aux écrans de style de texte et de sécurité. Quand il vous demande si vous faites confiance au dossier, appuyez sur ↓ pour choisir Yes, I trust this folder, puis sur Entrée : l'option présélectionnée, No, exit, ferme Claude Code. Pas besoin de compte Anthropic.

Vous n'avez pas encore Claude Code ? Dans PowerShell, lancez irm https://claude.ai/install.ps1 | iex. Sur macOS ou Linux, lancez curl -fsSL https://claude.ai/install.sh | bash. Si l'installateur indique que son dossier n'est pas dans votre PATH, suivez ses instructions. Si vous utilisez le terminal intégré de VS Code ou de Cursor, redémarrez l'éditeur après avoir collé la ligne.

Pourquoi le nom du modèle ? Sans lui, Claude Code croit parler à Claude Opus 5.5, quel que soit le modèle de votre clé. Il le dit au modèle et signe les commits avec ce nom. Avec le nom, il connaît le vrai modèle. Si le modèle n'est pas un Claude, Claude Code peut indiquer qu'il ne le reconnaît pas. Ce n'est pas grave : il ne connaît que les modèles Claude par leur nom, et les requêtes fonctionnent quand même.

Vous préférez un fichier ? Mettez ceci dans ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json) :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokenlowcost.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-tlc-your-key",
    "ANTHROPIC_MODEL": "claude-opus-5-5[1m]"
  }
}

Mettez dans ANTHROPIC_MODEL le modèle de votre clé : claude-opus-5-5, claude-sonnet-5, claude-haiku-4-5 ou, pour les autres modèles, l'ID de la grille tarifaire, comme gpt-6-sol. Ajoutez [1m] à la fin si la fenêtre de la clé dépasse 200K.

Claude Code envoie aussi de petites requêtes en arrière-plan, par exemple pour les titres de conversation. Elles utilisent le modèle de votre clé et sont facturées comme les autres.

Cx

Codex

Une ligne à coller

Une ligne écrit le fichier de configuration de Codex et enregistre votre clé. Si vous avez déjà une configuration Codex, elle est conservée sous le nom config.toml.bak. Cette ligne contient une clé factice ; le tableau de bord l'affiche avec la vôtre.


          

        

Collez-la dans PowerShell (Windows) ou Terminal (macOS, Linux) et appuyez sur Entrée. Lancez ensuite codex dans la même fenêtre et choisissez Trust and continue. Pas besoin de compte ChatGPT.

Vous n'avez pas encore Codex ? Installez-le avec npm install -g @openai/codex. Codex fonctionne mieux avec les modèles OpenAI, comme GPT-6 Sol.

Vous préférez modifier le fichier vous-même ? Voici ce que la ligne écrit dans ~/.codex/config.toml. Si vous l'ajoutez à un fichier existant, gardez les premières lignes au-dessus de toute [section].

Codex lit votre clé dans la variable d'environnement TOKENLOWCOST_API_KEY, que la ligne définit aussi. Définissez-la vous-même : ajoutez export TOKENLOWCOST_API_KEY=sk-tlc-your-key à ~/.zshrc ou ~/.bashrc, ou sous Windows lancez setx TOKENLOWCOST_API_KEY sk-tlc-your-key et ouvrez une nouvelle fenêtre.

Cl

Cline, Roo Code et Continue

Extensions pour VS Code et JetBrains

Dans Cline ou Roo Code, ouvrez les réglages du fournisseur et remplissez les champs ci-dessous. À la première ouverture de Cline, choisissez Bring my own API key pour y accéder. Une fois la clé saisie, la liste des modèles n'affiche que le modèle de votre clé : sélectionnez-le.

API Provider  OpenAI Compatible
Base URL      https://api.tokenlowcost.com/v1
API Key       sk-tlc-your-key
Model ID      anthropic/claude-opus-5.5

Cline affiche un coût de $0, car il ne connaît pas nos prix. Le coût réel se trouve dans Utilisation, sur votre tableau de bord.

Roo Code bloqué sur API Request… ? Depuis VS Code 1.122, Roo Code 3.54 ne trouve plus l'outil de recherche de fichiers que VS Code a déplacé, quel que soit le fournisseur. Ce ticket VS Code propose un contournement. Cline n'a pas ce problème.

Pour Continue, mettez ceci dans ~/.continue/config.yaml à la place du contenu existant. Vous avez déjà des modèles ? Ajoutez seulement l'entrée TokenLowCost sous models:. La ligne tool_use permet au mode Agent de modifier des fichiers ; sans elle, Continue ne sait pas que le modèle dispose d'outils.

name: My Config
version: 0.0.1
schema: v1
models:
  - name: TokenLowCost
    provider: openai
    model: tlc-opus
    apiBase: https://api.tokenlowcost.com/v1
    apiKey: sk-tlc-your-key
    capabilities:
      - tool_use

Tout autre outil proposant l'option OpenAI Compatible fonctionne de la même façon.

OA

OpenAI SDK

Python et TypeScript

Définissez l'URL de base et votre clé. Le reste, c'est le code habituel du SDK.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.tokenlowcost.com/v1",
    api_key="sk-tlc-your-key",
)

r = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tokenlowcost.com/v1",
  apiKey: "sk-tlc-your-key",
});

const r = await client.chat.completions.create({
  model: "claude-opus-5.5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);

Les exemples TypeScript de cette page sont des modules ES : enregistrez-en un sous le nom main.mts et lancez npx tsx main.mts.

Streaming

Ajoutez stream=True. Le nombre de tokens arrive dans le dernier chunk, qui peut ne contenir aucun choices : vérifiez d'abord chunk.choices.

stream = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Write a haiku about caching"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")

L'API Responses fonctionne aussi : client.responses.create(...).

An

Anthropic SDK

Python et TypeScript

Utilisez la même URL de base que partout ailleurs. Le SDK y ajoute /v1/messages, et c'est normal. Certains modèles envoient un bloc de réflexion avant le texte : l'exemple n'affiche donc que les blocs de texte.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.tokenlowcost.com/v1",
    api_key="sk-tlc-your-key",
)

msg = client.messages.create(
    model="claude-opus-5.5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello"}],
)
for block in msg.content:
    if block.type == "text":
        print(block.text)
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.tokenlowcost.com/v1",
  apiKey: "sk-tlc-your-key",
});

const msg = await client.messages.create({
  model: "claude-opus-5.5",
  max_tokens: 512,
  messages: [{ role: "user", content: "Hello" }],
});
for (const block of msg.content) {
  if (block.type === "text") console.log(block.text);
}
$_

cURL

Requêtes HTTP simples

La même clé fonctionne dans les trois formats de requête.

curl https://api.tokenlowcost.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tlc-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5.5", "messages": [{"role": "user", "content": "Hello"}]}'
curl https://api.tokenlowcost.com/v1/messages \
  -H "x-api-key: sk-tlc-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5.5", "max_tokens": 256, "messages": [{"role": "user", "content": "Hello"}]}'
curl https://api.tokenlowcost.com/v1/responses \
  -H "Authorization: Bearer sk-tlc-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "input": "Hello"}'

Consultez votre solde et vos 20 dernières requêtes :

curl https://api.tokenlowcost.com/v1/me -H "Authorization: Bearer sk-tlc-your-key"

Erreurs

Ce qu'elles signifient et que faire

Quand quelque chose ne va pas, vous recevez un code d'état et un court message.

CodeSignificationQue faire
401La clé est absente, erronée ou révoquée.Vérifiez que vous avez collé la clé en entier.
402La clé a atteint sa limite de dépenses, ou votre solde est à $0.Rechargez, ou créez une clé avec une limite plus élevée.
403La clé a expiré, ou le compte est banni. Le message précise lequel.Si elle a expiré, créez une nouvelle clé. Les bannissements sont expliqués dans les règles.
400Si le message indique que le prompt est trop long : la requête dépasse la fenêtre de contexte de la clé. Elle n'est pas facturée.Démarrez une nouvelle conversation, ou utilisez une clé avec une fenêtre plus grande.
404Mauvaise adresse.Vérifiez la partie après /v1.
AutresTransmis tel quel par le fournisseur du modèle, par exemple quand il est surchargé.Réessayez dans une minute.

Les limites de dépenses et les dates d'expiration se règlent par clé dans le tableau de bord. Votre solde se trouve dans Facturation.

Envie de connecter votre outil ?

Créez un compte, recevez $50 de crédit et créez votre première clé. Cela prend environ une minute.

Obtenir une clé API