> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# API Anthropic Messages

> Appelez les modèles libellés anthropic avec le protocole natif Anthropic Messages.

Utilisez cette API pour les modèles libellés `anthropic` dans le Catalogue ou la liste de modèles de votre clé. Consultez d'abord la [matrice des capacités](/fr/developer/capability-matrix) : **modèle, groupe de clé et protocole doivent correspondre**.

<Warning>
  **Messages n'est pas un endpoint universel**

  Pour une application compatible OpenAI, utilisez [Chat Completions](/fr/developer/openai-compatible). Ne basculez pas un canal Claude de type Anthropic vers `/v1/responses` : `not implemented` indique généralement une incompatibilité de protocole, pas une erreur temporaire.
</Warning>

## Endpoint et requête minimale

```text theme={"system"}
POST https://nexusapi.link/v1/messages
```

```bash theme={"system"}
curl 'https://nexusapi.link/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
    "model": "YOUR_ANTHROPIC_MODEL_ID",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Bonjour"}]
  }'
```

| Élément             | Requis                        | Note                                                                   |
| ------------------- | ----------------------------- | ---------------------------------------------------------------------- |
| `model`             | Oui                           | ID exact visible par la clé et libellé `anthropic`                     |
| `max_tokens`        | Oui                           | Nombre maximal de tokens en sortie                                     |
| `messages`          | Oui                           | Conversation au format Anthropic Messages                              |
| `anthropic-version` | Requis par le protocole natif | Géré par le SDK ; indiquez une version compatible pour un appel manuel |

Consultez la [référence API Apifox](https://nexusapi.apifox.cn/) et la documentation de votre client Anthropic pour tous les champs, outils, flux et schémas de réponse. Les champs facultatifs dépendent toujours du modèle et du canal.

## Utiliser le SDK Anthropic

Le SDK natif gère ses en-têtes de protocole. Passez-lui une clé NexusAPI et définissez l'URL de base **sans `/v1`** :

```python theme={"system"}
from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://nexusapi.link",
)

message = client.messages.create(
    model="YOUR_ANTHROPIC_MODEL_ID",
    max_tokens=256,
    messages=[{"role": "user", "content": "Bonjour"}],
)
```

Le SDK ajoute `/v1/messages`. N'utilisez pas `https://nexusapi.link/v1/messages` comme `base_url`, cela peut répéter le chemin ou produire une 404.

## Claude Code ou application maison

| Situation                    | Configuration                                                                                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code                  | Suivez le [guide Claude Code](/fr/tools/claude-code) : `ANTHROPIC_BASE_URL=https://nexusapi.link` et `ANTHROPIC_AUTH_TOKEN` dans `~/.claude/settings.json` |
| SDK Anthropic / client natif | URL de base `https://nexusapi.link`, puis laissez le client envoyer Messages                                                                               |
| Application avec SDK OpenAI  | Ne mélangez pas cette configuration ; utilisez [Chat Completions](/fr/developer/openai-compatible)                                                         |

## Dépannage

* `401` : vérifiez la clé, son état et l'absence de réinitialisation après exposition.
* `404` : vérifiez qu'un SDK n'a pas ajouté un second `/v1`.
* `400` : testez seulement `model`, `max_tokens` et `messages`, puis ajoutez les champs facultatifs un par un.
* `500, not implemented` : vérifiez qu'un modèle Anthropic ne passe pas par `/v1/responses`.

En cas d'échec persistant, conservez le Request ID et une requête expurgée, puis suivez l'[auto-vérification](/fr/faq/self-check).