Messages API

POST /v1/messages

Compatibile con l'API Messages di Anthropic. Il gateway fa da proxy in modo trasparente verso i modelli Claude tramite il canale Anthropic o Bedrock configurato.

Corpo della richiesta

Parametro	Tipo	Descrizione
`model`*	`string`	ID del modello da usare (es. claude-sonnet-4-6).
`messages`*	`array`	Array di oggetti messaggio con role (user/assistant) e content.
`max_tokens`*	`integer`	Numero massimo di token da generare.
`system`	`string`	Prompt di sistema per impostare il contesto della conversazione.
`stream`	`boolean`	Se true, restituisce uno stream di eventi SSE. Default: false.
`temperature`	`number`	Temperatura di campionamento 0–1. Default: 1.
`tools`	`array`	Elenco di definizioni di strumenti per il tool use.

Esempio di richiesta

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 256,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

Esempio di risposta

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "The capital of France is Paris." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 9
  }
}

ℹ

L'API Messages accetta sia Authorization: Bearer che x-api-key come header per l'autenticazione, in linea con la convenzione dell'SDK Anthropic.