> ## 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.

# Guida rapida all'API Claude: invia richieste Messages con CometAPI

> Chiama i modelli Claude tramite l'API Anthropic Messages compatibile di CometAPI con curl, Python e Node.js.

## Cosa realizzerai

Invierai una richiesta a `POST /v1/messages`, stamperai il testo della risposta di Claude e manterrai il codice pronto per l'uso con l'SDK Anthropic o HTTP diretto.

## Prerequisiti

* Una chiave API CometAPI salvata in `COMETAPI_KEY`
* Un model ID Claude dalla [pagina Models](/it/overview/models)
* `curl`, Python 3.10+ oppure Node.js 18+

## Chiave API, URL di base, autenticazione

Usa l'endpoint Messages compatibile con Anthropic tramite CometAPI:

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

Autentica le richieste HTTP dirette con `x-api-key` e l'header della versione API Anthropic:

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

## Esempi di codice

Usa le schede qui sotto per esempi copiabili in cURL, Python e 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>

## Spiegazione del flusso

Le richieste Claude Messages sono sincrone per impostazione predefinita. L'API restituisce un oggetto message in una singola risposta HTTP e la tua applicazione legge il primo blocco di contenuto testuale.

Usa questa route quando hai bisogno di strutture di richiesta specifiche di Claude, come array di messaggi Anthropic, extended thinking, prompt caching o tool use. Se la tua applicazione usa già l'SDK ufficiale di Anthropic, imposta l'URL di base dell'SDK su `https://api.cometapi.com` e mantieni la struttura di richiesta dell'API Messages.

## Parametri comuni

| Parameter    | Use                                                                            |
| ------------ | ------------------------------------------------------------------------------ |
| `model`      | Un model ID Claude disponibile per il tuo account.                             |
| `max_tokens` | Budget massimo di token di risposta per la risposta dell'API Messages.         |
| `messages`   | Array di messaggi Anthropic con ruoli `user` e `assistant`.                    |
| `stream`     | Trasmette eventi message incrementali quando è impostato su `true`.            |
| `thinking`   | Abilita extended thinking di Claude quando il modello selezionato lo supporta. |

## Risoluzione dei problemi / FAQ

<AccordionGroup>
  <Accordion title="La richiesta restituisce 401">
    Conferma che `COMETAPI_KEY` sia impostata nella stessa shell o nello stesso runtime che invia la richiesta. Non incollare una chiave reale nei file sorgente.
  </Accordion>

  <Accordion title="L'SDK continua a chiamare Anthropic direttamente">
    Conferma che il client SDK imposti `base_url` in Python o `baseURL` in Node.js su `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Quale modello dovrei usare">
    Usa un model ID Claude disponibile per il tuo account. Questa guida rapida non include un modello Claude codificato in modo fisso perché la disponibilità cambia in base all'account e alla famiglia di modelli.
  </Accordion>
</AccordionGroup>

## Passaggi successivi

* Usa il [riferimento dell'API Anthropic Messages](/api/text/anthropic-messages) per tutti i campi di richiesta e risposta.
* Controlla la disponibilità dei modelli in [Models](/it/overview/models).
* Configura sessioni di coding locali con la [guida all'integrazione Claude Code](/it/integrations/claude-code).
* Consulta il comportamento dei retry in [Codici di errore e strategia di retry](/it/guides/error-codes-and-retry-strategy).