Source: https://aiprimetech.io/it/docs/api-reference/messages/

[Home](/it/) / [Documentazione](/it/docs/) / API Messages 

# API Messages 

POST /v1/messages — l'endpoint in formato Anthropic: parametri, struttura della risposta ed esempi. 

 Copia pagina [ Visualizza in Markdown](/it/docs/api-reference/messages.md) [ Chiedi a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Chiedi in Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

L'endpoint utilizzato da tutti i client compatibili con Anthropic, inclusi Claude Code e gli SDK ufficiali. 

EndpointPOST https://aiprimetech.io/v1/messages

Autenticazionex-api-key: sk-...

Header della versioneanthropic-version: 2023-06-01

Tipo di contenutoapplication/json 

## Corpo della richiesta 

 | Campo | Tipo | Obbligatorio | Descrizione

 | model | stringa | sì | ID del modello, esattamente come elencato da /v1/models

 | messages | array | sì | Turni alternati di utente e assistente, dal più vecchio

 | max_tokens | intero | sì | Numero massimo di token di output. La generazione si arresta a questo limite.

 | system | stringa o array | no | Prompt di sistema al livello principale. Non è un ruolo del messaggio.

 | temperature | numero | no | 0–1. Ometti per usare il valore predefinito del modello.

 | top_p | numero | no | Campionamento nucleus. Usa questo parametro oppure la temperatura, non entrambi.

 | stop_sequences | array | no | Stringhe che interrompono la generazione quando vengono prodotte

 | stream | booleano | no | true per gli eventi inviati dal server

 | tools | array | no | Definizioni degli strumenti: vedi [Uso degli strumenti](/it/docs/api-reference/tool-use/)

 | metadata | oggetto | no | Trasferito senza modifiche; user_id è utile per le tue attribuzioni 

## Esempio 

```
Copycurl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

## Risposta 

```
Copy{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}
```

 | Campo | Descrizione

 | content | Array di blocchi. I blocchi di testo contengono type: text e un text campo; le chiamate agli strumenti contengono type: tool_use.

 | stop_reason | end_turn, max_tokens, stop_sequence o tool_use

 | usage.input_tokens | Input fatturato, inclusa l'intera cronologia reinviata

 | usage.output_tokens | Output fatturato: in genere 4–5× la tariffa dell'input 

## Prompt di sistema 

```
Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}
```

Un blocco stabile di tipo system è il candidato ideale per [la cache dei prompt](/it/docs/guides/prompt-caching/) : è identico a ogni chiamata, quindi può essere letto dalla cache a una frazione del prezzo dell'input. 

## Input multimodale 

I blocchi immagine usano la struttura standard di Anthropic: vedi [Visione](/it/docs/api-reference/vision/). 

[StreamingOutput token per token](/it/docs/api-reference/streaming/)[Uso degli strumentiChiamata di funzioni](/it/docs/api-reference/tool-use/)[ErroriModalità di errore](/it/docs/api-reference/errors/) 

[PrecedentePanoramica dell'API](/it/docs/api-reference/overview/)[AvantiAPI Chat Completions](/it/docs/api-reference/chat-completions/)