---
title: "Base URL, interfaces et authentification"
description: "Base URL de 1折AI, interfaces disponibles, écriture des en-têtes de requête, et si ajouter /v1 selon l'outil."
headingIds: {"Interfaces disponibles":"section-1","Ajouter ou non /v1":"section-2","En-têtes d’authentification":"section-3","Vérifier si une clé API est utilisable":"section-4","Limites de débit":"section-5","Réseau":"section-6"}
---
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](/fr/docs/pricing-explained/#section-3).
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 :
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="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](/fr/docs/troubleshooting/).
## 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](/fr/docs/troubleshooting/).
## 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`.