Visione

​

Come utilizzare la visione

• claude.ai. Carica un’immagine come faresti con un file, o trascina e rilascia un’immagine direttamente nella finestra di chat.
• Il Console Workbench. Se selezioni un modello che accetta immagini (solo modelli Claude 3 e 4), appare un pulsante per aggiungere immagini in alto a destra di ogni blocco messaggio Utente.
• Richiesta API. Vedi gli esempi in questa guida.

​

Prima di caricare

​

Nozioni di base e limiti

​

Valutare la dimensione dell’immagine

​

Calcolare i costi delle immagini

​

Garantire la qualità dell’immagine

• Formato immagine: Usa un formato immagine supportato: JPEG, PNG, GIF o WebP.
• Chiarezza dell’immagine: Assicurati che le immagini siano chiare e non troppo sfocate o pixelate.
• Testo: Se l’immagine contiene testo importante, assicurati che sia leggibile e non troppo piccolo. Evita di ritagliare il contesto visuale chiave solo per ingrandire il testo.

​

Esempi di prompt

​

Informazioni sugli esempi di prompt

1. Come immagine codificata in base64 nei blocchi di contenuto image
2. Come riferimento URL a un’immagine ospitata online
3. Utilizzando l’API Files (carica una volta, usa più volte)

    # Per immagini basate su URL, puoi usare l'URL direttamente nella tua richiesta JSON
    
    # Per immagini codificate in base64, devi prima codificare l'immagine
    # Esempio di come codificare un'immagine in base64 in bash:
    BASE64_IMAGE_DATA=$(curl -s "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg" | base64)
    
    # I dati codificati possono ora essere utilizzati nelle tue chiamate API

​

Esempio di immagine codificata in base64

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "base64",
              "media_type": "image/jpeg",
              "data": "'"$BASE64_IMAGE_DATA"'"
            }
          },
          {
            "type": "text",
            "text": "Descrivi questa immagine."
          }
        ]
      }
    ]
  }'

​

Esempio di immagine basata su URL

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "url",
              "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
            }
          },
          {
            "type": "text",
            "text": "Descrivi questa immagine."
          }
        ]
      }
    ]
  }'

​

Esempio di immagine API Files

# Prima, carica la tua immagine nell'API Files
curl -X POST https://api.anthropic.com/v1/files \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -F "file=@image.jpg"

# Poi usa il file_id restituito nel tuo messaggio
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "file",
              "file_id": "file_abc123"
            }
          },
          {
            "type": "text",
            "text": "Descrivi questa immagine."
          }
        ]
      }
    ]
  }'

​

Limitazioni

• Identificazione di persone: Claude non può essere utilizzato per identificare (cioè, nominare) persone nelle immagini e si rifiuterà di farlo.
• Accuratezza: Claude può allucinare o commettere errori quando interpreta immagini di bassa qualità, ruotate, o molto piccole sotto i 200 pixel.
• Ragionamento spaziale: Le capacità di ragionamento spaziale di Claude sono limitate. Può avere difficoltà con compiti che richiedono localizzazione precisa o layout, come leggere il quadrante di un orologio analogico o descrivere posizioni esatte dei pezzi degli scacchi.
• Conteggio: Claude può dare conteggi approssimativi di oggetti in un’immagine ma potrebbe non essere sempre precisamente accurato, specialmente con grandi numeri di oggetti piccoli.
• Immagini generate da AI: Claude non sa se un’immagine è generata da AI e potrebbe essere scorretto se richiesto. Non fare affidamento su di esso per rilevare immagini false o sintetiche.
• Contenuto inappropriato: Claude non processerà immagini inappropriate o esplicite che violano la nostra Politica di Uso Accettabile.
• Applicazioni sanitarie: Mentre Claude può analizzare immagini mediche generali, non è progettato per interpretare scansioni diagnostiche complesse come TC o risonanze magnetiche. Gli output di Claude non dovrebbero essere considerati un sostituto per consigli medici professionali o diagnosi.

​

FAQ

​

Approfondire la visione

• Cookbook multimodale: Questo cookbook ha consigli su come iniziare con le immagini e tecniche delle migliori pratiche per garantire le prestazioni di qualità più alta con le immagini. Vedi come puoi effettivamente fare prompt a Claude con immagini per svolgere compiti come interpretare e analizzare grafici o estrarre contenuto da moduli.
• Riferimento API: Visita la nostra documentazione per l’API Messages, inclusi esempi di chiamate API che coinvolgono immagini.