Base URL, interfaces et authentification

Documentation maintenue par 1ZheAI. Sources et corrections.

Vous avez trouvé une erreur ? Contactez l’assistance en indiquant l’adresse de la page et une description. N’envoyez pas de clés API ni d’identifiants de compte.

Toutes les requêtes sont envoyées vers le même domaine, avec deux jeux de chemins selon le protocole.

text

https://1zheai.com

Interfaces disponibles

Interface	Protocole	Usage
POST /v1/messages	Natif Anthropic	Conversation. Claude Code, Anthropic SDK, Cline (mode Anthropic) passent par ici
POST /v1/chat/completions	Compatible OpenAI	Conversation. OpenAI SDK, Cursor, Cherry Studio (mode OpenAI) passent par ici
GET /v1/models	Compatible OpenAI	Liste les modèles utilisables par votre clé API (API key)
POST /v1/messages/count_tokens	Natif Anthropic	Compte le nombre de tokens d’une entrée, ne génère pas de conversation, ne facture pas

Le corps de la requête de count_tokens est identique à celui de /v1/messages (model, messages, peut inclure system et tools) ; la réponse ne contient qu’un seul champ :

json

{"input_tokens":19}

count_tokens ne compte que ce que vous envoyez. Lors d’un appel réel via SDK, curl ou outil tiers, chaque requête inclut en plus une invite système, facturée en tokens d’entrée (Claude Code n’en inclut pas) ; voir la facturation des invites système.

Les capacités propres à Claude comme le Prompt Caching, l’extended thinking et les appels d’outils fonctionnent le plus de manière fiable avec l’interface native /v1/messages. L’interface compatible OpenAI convient aux cas où vous avez déjà du code OpenAI et souhaitez simplement changer de modèle.

Ajouter ou non /v1

Différents outils interprètent le Base URL différemment ; c’est le piège le plus courant lors de l’intégration :

Outil / SDK	Ce qu’il faut renseigner	Raison
Claude Code (ANTHROPIC_BASE_URL)	https://1zheai.com	L’outil assemble lui-même /v1/messages
Anthropic SDK (base_url)	https://1zheai.com	Idem
OpenAI SDK (base_url)	https://1zheai.com/v1	Le SDK assemble uniquement /chat/completions
Cursor (Override OpenAI Base URL)	https://1zheai.com/v1	Comme l’OpenAI SDK
Cherry Studio	https://1zheai.com	Ajoute automatiquement /v1/...
Cline (OpenAI Compatible)	https://1zheai.com/v1	Comme l’OpenAI SDK

Règle : la famille Anthropic prend l’adresse racine, la famille OpenAI jusqu’à /v1. Une erreur de saisie se manifeste typiquement par un 404.

En-têtes d’authentification

La clé API est placée dans l’en-tête de requête ; les deux écritures suivantes fonctionnent :

Anthropic 原生

Anthropic 原生

x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json

Bearer（两种协议都支持）

Bearer（两种协议都支持）

Authorization: Bearer sk-你的Key
content-type: application/json

• Lors de l’appel à /v1/messages, incluez anthropic-version conformément au protocole officiel ; la valeur actuelle est 2023-06-01. En test, l’appel fonctionne aussi sans, mais les SDK et outils officiels l’incluent ; faites de même lorsque vous écrivez vos propres requêtes.
• Le ANTHROPIC_AUTH_TOKEN de Claude Code envoie Authorization: Bearer, et ANTHROPIC_API_KEY envoie x-api-key ; nous acceptons les deux.
• Lorsque vous avez besoin d’une fonctionnalité beta, incluez l’en-tête anthropic-beta conformément à la documentation officielle. Inclure une valeur inconnue ne provoque pas d’erreur ; l’effet réel d’une fonctionnalité beta se juge donc sur l’effet observé dans la réponse.

Vérifier si une clé API est utilisable

bash

curl https://1zheai.com/v1/models \
  -H "Authorization: Bearer sk-你的Key"

La renvoi de la liste des modèles indique que la clé API et l’adresse sont correctes. Un 401 provient de la clé API ; la réponse ressemble à ceci (testé le 2026-10-15) :

json

{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}

Lors d’une requête à /v1/models avec les en-têtes x-api-key et anthropic-version, la réponse est une liste de modèles au format Anthropic (data[].id, display_name, has_more) ; c’est ce format que lit la découverte automatique des modèles de Claude Code.

Pour les autres cas, voir codes d’erreur et dépannage.

Limites de débit

Aucune limite de débit n’est actuellement appliquée aux clés API. En cas de 429, il s’agit généralement d’une charge amont élevée ; réessayez plus tard, et ajoutez un backoff exponentiel pour les tâches par lots. Voir codes d’erreur et dépannage.

Réseau

En cas de délai d’expiration de connexion ou d’erreur TLS, vérifiez d’abord le réseau utilisé par le terminal : si un proxy global est actif, désactivez-le et réessayez en connexion directe ; sur un réseau d’entreprise avec liste blanche de sortie, autorisez 1zheai.com.