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

# Démarrage rapide de l’API Claude : envoyer des requêtes Messages avec CometAPI

> Appelez les modèles Claude via l’API Messages compatible Anthropic de CometAPI avec curl, Python et Node.js.

## Ce que vous allez créer

Vous enverrez une requête à `POST /v1/messages`, afficherez le texte de réponse de Claude et garderez le code prêt pour une utilisation avec le SDK Anthropic ou en HTTP direct.

## Prérequis

* Une clé API CometAPI stockée dans `COMETAPI_KEY`
* Un model ID Claude depuis la page [Models](/fr/overview/models)
* `curl`, Python 3.10+ ou Node.js 18+

## Clé API, URL de base, authentification

Utilisez le endpoint Messages compatible Anthropic via CometAPI :

```text theme={null}
https://api.cometapi.com/v1/messages
```

Authentifiez les requêtes HTTP directes avec `x-api-key` et l’en-tête de version d’API Anthropic :

```text theme={null}
x-api-key: $COMETAPI_KEY
anthropic-version: 2023-06-01
```

## Exemples de code

Utilisez les onglets ci-dessous pour des exemples copiables en cURL, Python et Node.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: $COMETAPI_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "your-claude-model-id",
      "max_tokens": 256,
      "messages": [
        {
          "role": "user",
          "content": "Reply with one short sentence."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import anthropic

  client = anthropic.Anthropic(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com",
  )

  message = client.messages.create(
      model="your-claude-model-id",
      max_tokens=256,
      messages=[
          {
              "role": "user",
              "content": "Reply with one short sentence.",
          }
      ],
  )

  print(message.content[0].text)
  ```

  ```javascript Node.js theme={null}
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
  });

  const message = await client.messages.create({
    model: "your-claude-model-id",
    max_tokens: 256,
    messages: [
      {
        role: "user",
        content: "Reply with one short sentence.",
      },
    ],
  });

  console.log(message.content[0].text);
  ```
</CodeGroup>

## Explication du flux

Les requêtes Claude Messages sont synchrones par défaut. L’API renvoie un objet message dans une seule réponse HTTP, et votre application lit le premier bloc de contenu textuel.

Utilisez cette route lorsque vous avez besoin de formes de requête spécifiques à Claude, comme les tableaux de messages Anthropic, la réflexion étendue, la mise en cache de prompt ou l’utilisation d’outils. Si votre application utilise déjà le SDK officiel Anthropic, définissez l’URL de base du SDK sur `https://api.cometapi.com` et conservez la forme de requête de l’API Messages.

## Paramètres courants

| Parameter    | Use                                                                                     |
| ------------ | --------------------------------------------------------------------------------------- |
| `model`      | Un model ID Claude disponible pour votre compte.                                        |
| `max_tokens` | Budget maximal de tokens de réponse pour la réponse de l’API Messages.                  |
| `messages`   | Tableau de messages Anthropic avec les rôles `user` et `assistant`.                     |
| `stream`     | Diffuse des événements de message incrémentaux lorsqu’il est défini sur `true`.         |
| `thinking`   | Active la réflexion étendue de Claude lorsque le modèle sélectionné la prend en charge. |

## Dépannage / FAQ

<AccordionGroup>
  <Accordion title="La requête renvoie 401">
    Vérifiez que `COMETAPI_KEY` est défini dans le même shell ou environnement d’exécution qui envoie la requête. Ne collez pas de vraie clé dans les fichiers source.
  </Accordion>

  <Accordion title="Le SDK appelle toujours Anthropic directement">
    Vérifiez que le client SDK définit `base_url` en Python ou `baseURL` en Node.js sur `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Quel modèle dois-je utiliser">
    Utilisez un model ID Claude disponible pour votre compte. Ce guide de démarrage rapide ne fixe pas de modèle Claude en dur, car la disponibilité varie selon le compte et la famille de modèles.
  </Accordion>
</AccordionGroup>

## Étapes suivantes

* Utilisez la [référence de l’API Anthropic Messages](/api/text/anthropic-messages) pour tous les champs de requête et de réponse.
* Vérifiez la disponibilité des modèles dans [Models](/fr/overview/models).
* Configurez des sessions de codage locales avec le [guide d’intégration Claude Code](/fr/integrations/claude-code).
* Consultez le comportement de nouvelle tentative dans [Codes d’erreur et stratégie de retry](/fr/guides/error-codes-and-retry-strategy).