Home / Documentazione / API Messages

API Messages

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

Visualizza in Markdown Chiedi a ChatGPT Chiedi in Claude

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
`metadata`	oggetto	no	Trasferito senza modifiche; `user_id` è utile per le tue attribuzioni

Esempio

curl 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

{
  "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

{
  "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 : è 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.

StreamingOutput token per token Uso degli strumentiChiamata di funzioni ErroriModalità di errore