Appels de modèles

Comment renseigner correctement la Base URL ?

Comprenez comment associer la Base URL, les chemins /v1, l’API Key et le Model ID dans Claude Code, Codex CLI, Cursor, Cline et d’autres outils. En pratique.

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://bettertoken.ai`
Codex CLI / compatible avec OpenAI	`https://bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://bettertoken.ai/v1`

Utilisez https://bettertoken.ai pour Claude Code et https://bettertoken.ai/v1 pour Codex CLI et les outils OpenAI-compatible. Choisissez l’adresse selon le protocole du client.

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

Utilisez https://bettertoken.ai pour Claude Code et https://bettertoken.ai/v1 pour Codex CLI et les outils OpenAI-compatible. Choisissez l’adresse selon le protocole du client.

Référence rapide

Outil	Configuration recommandée
Claude Code	`https://bettertoken.ai` avec une BetterToken API Key
Claude Desktop Gateway	Suivez la page du Gateway, y compris le mode d’authentification
Codex CLI	`https://bettertoken.ai/v1` avec une BetterToken API Key
Cursor	`https://bettertoken.ai/v1` avec une BetterToken API Key
Cline	`https://bettertoken.ai/v1` avec un fournisseur OpenAI Compatible
OpenCode / OpenClaw	`https://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`	Vérifiez le Model ID exact dans la model plaza et saisissez-le dans les paramètres du modèle du client.
`invalid_api_key`	L’API Key et la Base URL proviennent de services différents
L’authentification fonctionne, mais le modèle est indisponible	Vérifiez le Model ID exact dans la model plaza et saisissez-le dans les paramètres du modèle du client.
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.
Copiez le Model ID exact depuis la model plaza.
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://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://bettertoken.ai"
)

message = client.messages.create(
    model="your-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://bettertoken.ai ; Codex CLI, Cursor, Cline, OpenCode et OpenClaw utilisent https://bettertoken.ai/v1.