Consulta la documentazione di riferimento dell’API per la documentazione completa sui parametri disponibili.

Richiesta e risposta di base

JSON
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Ciao!"
    }
  ],
  "model": "claude-3-5-sonnet-20240620",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 6
  }
}

Più turni di conversazione

L’API dei messaggi è senza stato, il che significa che invii sempre l’intera cronologia della conversazione all’API. Puoi utilizzare questo modello per costruire una conversazione nel tempo. I turni di conversazione precedenti non devono necessariamente provenire effettivamente da Claude — puoi utilizzare messaggi assistant sintetici.

Shell
#!/bin/sh
curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-3-5-sonnet-20240620",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Ciao, Claude"},
        {"role": "assistant", "content": "Ciao!"},
        {"role": "user", "content": "Puoi descrivermi gli LLM?"}
        
    ]
}'
Python
import anthropic

message = anthropic.Anthropic().messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Ciao, Claude"},
        {"role": "assistant", "content": "Ciao!"},
        {"role": "user", "content": "Puoi descrivermi gli LLM?"}
    ],
)
print(message)

TypeScript
import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic();

await anthropic.messages.create({
  model: 'claude-3-5-sonnet-20240620',
  max_tokens: 1024,
  messages: [
    {"role": "user", "content": "Ciao, Claude"},
    {"role": "assistant", "content": "Ciao!"},
    {"role": "user", "content": "Puoi descrivermi gli LLM?"}
  ]
});
JSON
{
    "id": "msg_018gCsTGsXkYJVqYPxTgDHBU",
    "type": "message",
    "role": "assistant",
    "content": [
        {
            "type": "text",
            "text": "Certamente, sarei felice di fornire..."
        }
    ],
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "usage": {
      "input_tokens": 30,
      "output_tokens": 309
    }
}

Mettere le parole in bocca a Claude

Puoi pre-compilare parte della risposta di Claude nell’ultima posizione dell’elenco dei messaggi di input. Questo può essere utilizzato per modellare la risposta di Claude. L’esempio seguente utilizza "max_tokens": 1 per ottenere una singola risposta a scelta multipla da Claude.

JSON
{
  "id": "msg_01Q8Faay6S7QPTvEUUQARt7h",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "C"
    }
  ],
  "model": "claude-3-5-sonnet-20240620",
  "stop_reason": "max_tokens",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 42,
    "output_tokens": 1
  }
}

Visione

Claude può leggere sia testo che immagini nelle richieste. Attualmente, supportiamo il tipo di sorgente base64 per le immagini e i tipi di media image/jpeg, image/png, image/gif e image/webp. Consulta la nostra guida alla visione per maggiori dettagli.

JSON
{
  "id": "msg_01EcyWo6m4hyW8KHs2y2pei5",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Questa immagine mostra una formica, in particolare una vista ravvicinata di una formica. La formica è mostrata in dettaglio, con la sua testa distinta, le antenne e le zampe chiaramente visibili. L'immagine si concentra sulla cattura dei dettagli e delle caratteristiche intricati della formica, probabilmente scattata con un obiettivo macro per ottenere una prospettiva estremamente ravvicinata."
    }
  ],
  "model": "claude-3-5-sonnet-20240620",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 1551,
    "output_tokens": 71
  }
}

Uso di strumenti e modalità JSON

Consulta la nostra guida per esempi su come utilizzare gli strumenti con l’API dei messaggi.