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.
https://api.tokenlowcost.com/v1Démarrage rapide
-
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.
-
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.
-
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
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
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.
Quand les requêtes s'arrêtent
| Ce qui s'est passé | Résultat |
|---|---|
| Limite de la clé atteinte | 402 pour cette clé. Vos autres clés continuent de fonctionner. |
| Clé expirée | 403 pour cette clé. |
| Clé révoquée | 401 immédiatement. C'est irréversible. |
| Solde à $0 | 402 pour toutes les clés jusqu'à la recharge. Le solde ne passe jamais sous zéro. |
| Compte banni | 403 pour toutes les clés, et vous ne pouvez plus vous connecter. Les bannissements sanctionnent les infractions aux règles. |
Contexte et effort
À 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églage | Effet |
|---|---|
| Fenêtre de contexte | La 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.
Cursor
Ouvrez les paramètres
Dans Cursor, ouvrez Settings → Models et descendez jusqu'à API Keys.
-
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
Ajoutez un nom de modèle
Cliquez sur + Add model, tapez un nom comme
tlc-opuset 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é.Vérifiez et discutez
Cliquez sur Verify à côté de la clé. Puis choisissez votre modèle dans le chat.
VS Code
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.
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.
Saisissez un nom et votre clé
Nommez-le TokenLowCost et collez votre clé. À l'étape API Type, appuyez simplement sur Entrée.
-
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 remplacezidetnamepar ceux de votre modèle. Choisissez le modèle
Ouvrez le chat, cliquez sur le nom du modèle dans la zone de saisie et choisissez votre modèle.
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.
Claude Code
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.
Collez la ligne
Collez-la dans PowerShell (Windows) ou Terminal (macOS, Linux) et appuyez sur Entrée.
Lancez Claude Code
Lancez
claudedans 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.
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.
Codex
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.
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.
Cline, Roo Code et Continue
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.
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_useTout autre outil proposant l'option OpenAI Compatible fonctionne de la même façon.
OpenAI SDK
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(...).
Anthropic SDK
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
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
Quand quelque chose ne va pas, vous recevez un code d'état et un court message.
| Code | Signification | Que faire |
|---|---|---|
| 401 | La clé est absente, erronée ou révoquée. | Vérifiez que vous avez collé la clé en entier. |
| 402 | La 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. |
| 403 | La 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. |
| 400 | Si 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. |
| 404 | Mauvaise adresse. | Vérifiez la partie après /v1. |
| Autres | Transmis 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.