Comment renseigner correctement la Base URL ?

Réponse courte

La Base URL doit correspondre au protocole attendu par votre outil. Claude Code utilise généralement l’adresse racine compatible avec Anthropic. Codex CLI, Cursor, Cline, OpenCode, OpenClaw et les autres outils externes utilisent généralement l’adresse /v1 compatible avec OpenAI. Dans BetterToken :

Cas d’utilisation	Base URL
Claude Code / compatible avec Anthropic	`https://www.bettertoken.ai`
Codex CLI / compatible avec OpenAI	`https://www.bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://www.bettertoken.ai/v1`

Ne devinez pas le chemin. L’API Key, la Base URL et le Model ID doivent provenir du même fournisseur ou de la même gateway.

Pourquoi plusieurs Base URL existent

Les SDK ajoutent les chemins de différentes manières.

Protocole ou type d’outil	Comportement habituel
SDK compatible avec OpenAI	Appelle généralement des ressources comme chat completions ou responses sous `/v1`
SDK compatible avec Anthropic	Ajoute généralement lui-même les chemins des endpoints de messages ; n’ajoutez donc pas de nouveau `/v1`
Fournisseur intégré à l’outil	Peut ajouter automatiquement les chemins ou demander une Base URL complète

Un même nom de modèle ne signifie pas que la même Base URL fonctionne partout. Le protocole de l’outil, la Base URL, l’API Key, le fournisseur et le Model ID doivent correspondre.

Référence rapide

Outil	Configuration recommandée
Claude Code	`https://www.bettertoken.ai` avec une BetterToken API Key
Claude Desktop Gateway	Suivez la page du Gateway, y compris le mode d’authentification
Codex CLI	`https://www.bettertoken.ai/v1` avec une BetterToken API Key
Cursor	`https://www.bettertoken.ai/v1` avec une BetterToken API Key
Cline	`https://www.bettertoken.ai/v1` avec un fournisseur OpenAI Compatible
OpenCode / OpenClaw	`https://www.bettertoken.ai/v1` avec une BetterToken API Key

Erreurs fréquentes

Erreur ou symptôme	Cause possible
`404 Not Found`	Le chemin de la Base URL ne correspond pas à celui attendu par le SDK
`model not found`	Le Model ID n’appartient pas au fournisseur actuel
`invalid_api_key`	L’API Key et la Base URL proviennent de services différents
L’authentification fonctionne, mais le modèle est indisponible	Le fournisseur et le Model ID ne correspondent pas
Les requêtes continuent d’échouer	Une adresse compatible avec Anthropic est utilisée dans un outil compatible avec OpenAI, ou inversement

Ordre recommandé pour le dépannage

Vérifiez si l’outil attend une API compatible avec OpenAI ou avec Anthropic.
Vérifiez que la Base URL correspond à ce protocole.
Vérifiez que l’API Key provient du même service.
Vérifiez que le Model ID provient du model plaza et appartient au fournisseur actuel.
Envoyez une requête de test minimale, par exemple hello.

Exemples de code

Les outils compatibles avec OpenAI utilisent généralement l’adresse /v1 :

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.bettertoken.ai/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)

Les configurations Claude ou compatibles avec Anthropic utilisent généralement l’adresse racine :

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://www.bettertoken.ai"
)

message = client.messages.create(
    model="your-claude-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)

À propos de BetterToken

BetterToken fournit un accès compatible avec Anthropic et OpenAI. Vous pouvez gérer les API Key, le solde et les relevés d’utilisation dans le même Dashboard, mais chaque client doit utiliser l’adresse du protocole qu’il prend en charge. Règle rapide : Claude Code utilise https://www.bettertoken.ai ; Codex CLI, Cursor, Cline, OpenCode et OpenClaw utilisent https://www.bettertoken.ai/v1.

Claude Code

Claude Desktop

Codex

Cursor

Cline

Appels de modèles

Service et sécurité

Coûts et tokens

Concepts

Comment renseigner correctement la Base URL ?

Réponse courte

Pourquoi plusieurs Base URL existent

Référence rapide

Erreurs fréquentes

Ordre recommandé pour le dépannage

Exemples de code

À propos de BetterToken

Documentation associée

​Réponse courte

​Pourquoi plusieurs Base URL existent

​Référence rapide

​Erreurs fréquentes

​Ordre recommandé pour le dépannage

​Exemples de code

​À propos de BetterToken

​Documentation associée

Réponse courte

Pourquoi plusieurs Base URL existent

Référence rapide

Erreurs fréquentes

Ordre recommandé pour le dépannage

Exemples de code

À propos de BetterToken

Documentation associée