Visione

Questa guida descrive come lavorare con le immagini in Claude, incluse le migliori pratiche, esempi di codice e limitazioni da tenere a mente.

Come utilizzare la visione

Usa le capacità di visione di Claude tramite:

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), apparirà un pulsante per aggiungere immagini in alto a destra di ogni blocco di messaggi Utente.
Richiesta API. Vedi gli esempi in questa guida.

Prima di caricare

Nozioni di base e limiti

Puoi includere più immagini in una singola richiesta (fino a 20 per claude.ai e 100 per le richieste API). Claude analizzerà tutte le immagini fornite quando formulerà la sua risposta. Questo può essere utile per confrontare o mettere a confronto le immagini.

Se invii un’immagine più grande di 8000x8000 px, verrà rifiutata. Se invii più di 20 immagini in una richiesta API, questo limite è di 2000x2000 px.

Valutare la dimensione dell’immagine

Per prestazioni ottimali, consigliamo di ridimensionare le immagini prima del caricamento se sono troppo grandi. Se il lato lungo della tua immagine è più di 1568 pixel, o la tua immagine è più di ~1.600 token, verrà prima ridimensionata, preservando le proporzioni, fino a rientrare nei limiti di dimensione.

Se la tua immagine di input è troppo grande e necessita di essere ridimensionata, aumenterà la latenza del time-to-first-token, senza darti alcuna prestazione aggiuntiva del modello. Immagini molto piccole sotto i 200 pixel su qualsiasi lato potrebbero degradare le prestazioni.

Per migliorare il time-to-first-token, consigliamo di ridimensionare le immagini a non più di 1,15 megapixel (e entro 1568 pixel in entrambe le dimensioni).

Ecco una tabella delle dimensioni massime delle immagini accettate dalla nostra API che non verranno ridimensionate per i rapporti di aspetto comuni. Con il modello Claude 3.7 Sonnet, queste immagini utilizzano circa 1.600 token e circa $4,80/1K immagini.

Rapporto di aspetto	Dimensione immagine
1:1	1092x1092 px
3:4	951x1268 px
2:3	896x1344 px
9:16	819x1456 px
1:2	784x1568 px

Calcolare i costi delle immagini

Ogni immagine che includi in una richiesta a Claude conta verso il tuo utilizzo di token. Per calcolare il costo approssimativo, moltiplica il numero approssimativo di token dell’immagine per il prezzo per token del modello che stai utilizzando.

Se la tua immagine non necessita di essere ridimensionata, puoi stimare il numero di token utilizzati attraverso questo algoritmo: token = (larghezza px * altezza px)/750

Ecco esempi di tokenizzazione approssimativa e costi per diverse dimensioni di immagini entro i vincoli di dimensione della nostra API basati sul prezzo per token di Claude 3.7 Sonnet di $3 per milione di token di input:

Dimensione immagine	# di Token	Costo / immagine	Costo / 1K immagini
200x200 px(0,04 megapixel)	~54	~$0,00016	~$0,16
1000x1000 px(1 megapixel)	~1334	~$0,004	~$4,00
1092x1092 px(1,19 megapixel)	~1590	~$0,0048	~$4,80

Garantire la qualità dell’immagine

Quando fornisci immagini a Claude, tieni presente quanto segue per ottenere i migliori risultati:

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 visivo chiave solo per ingrandire il testo.

Esempi di prompt

Molte delle tecniche di prompting che funzionano bene per le interazioni basate su testo con Claude possono essere applicate anche ai prompt basati su immagini.

Questi esempi dimostrano le strutture di prompt delle migliori pratiche che coinvolgono le immagini.

Proprio come con il posizionamento delle query dei documenti, Claude funziona meglio quando le immagini vengono prima del testo. Le immagini posizionate dopo il testo o interpolate con il testo funzioneranno comunque bene, ma se il tuo caso d’uso lo permette, consigliamo una struttura immagine-poi-testo.

Informazioni sugli esempi di prompt

I seguenti esempi dimostrano come utilizzare le capacità di visione di Claude utilizzando vari linguaggi di programmazione e approcci. Puoi fornire immagini a Claude in due modi:

Come immagine codificata in base64 nei blocchi di contenuto image
Come riferimento URL a un’immagine ospitata online

Gli esempi di prompt base64 utilizzano queste variabili:

    # Per le immagini basate su URL, puoi utilizzare l'URL direttamente nella tua richiesta JSON
    
    # Per le 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

Di seguito sono riportati esempi di come includere immagini in una richiesta Messages API utilizzando immagini codificate in base64 e riferimenti URL:

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-3-7-sonnet-20250219",
    "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-3-7-sonnet-20250219",
    "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."
          }
        ]
      }
    ]
  }'

Vedi Esempi API Messages per ulteriori esempi di codice e dettagli sui parametri.

Esempio: Una immagine

È meglio posizionare le immagini prima nel prompt rispetto alle domande su di esse o alle istruzioni per i compiti che le utilizzano.

Chiedi a Claude di descrivere un’immagine.

Ruolo	Contenuto
Utente	[Immagine] Descrivi questa immagine.

Ecco la corrispondente chiamata API utilizzando il modello Claude 3.7 Sonnet.

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Descrivi questa immagine."
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Descrivi questa immagine."
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    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: Immagini multiple

In situazioni in cui ci sono più immagini, introduci ogni immagine con Immagine 1: e Immagine 2: e così via. Non hai bisogno di nuove righe tra le immagini o tra le immagini e il prompt.

Chiedi a Claude di descrivere le differenze tra più immagini.

Ruolo	Contenuto
Utente	Immagine 1: [Immagine 1] Immagine 2: [Immagine 2] Come sono diverse queste immagini?

Ecco la corrispondente chiamata API utilizzando il modello Claude 3.7 Sonnet.

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Immagine 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Immagine 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Come sono diverse queste immagini?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Immagine 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Immagine 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Come sono diverse queste immagini?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Immagine 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "Immagine 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/b/b5/Iridescent.green.sweat.bee1.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "Come sono diverse queste immagini?"
                }
            ],
        }
    ],
)

Esempio: Immagini multiple con un prompt di sistema

Chiedi a Claude di descrivere le differenze tra più immagini, dandogli un prompt di sistema su come rispondere.

Contenuto
Sistema	Rispondi solo in spagnolo.
Utente	Immagine 1: [Immagine 1] Immagine 2: [Immagine 2] Come sono diverse queste immagini?

Ecco la corrispondente chiamata API utilizzando il modello Claude 3.7 Sonnet.

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    system="Rispondi solo in spagnolo.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Immagine 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Immagine 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Come sono diverse queste immagini?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    system="Rispondi solo in spagnolo.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Immagine 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Immagine 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Come sono diverse queste immagini?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    system="Rispondi solo in spagnolo.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Immagine 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "Immagine 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/b/b5/Iridescent.green.sweat.bee1.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "Come sono diverse queste immagini?"
                }
            ],
        }
    ],
)

Esempio: Quattro immagini in due turni di conversazione

Le capacità di visione di Claude brillano nelle conversazioni multimodali che mescolano immagini e testo. Puoi avere scambi estesi avanti e indietro con Claude, aggiungendo nuove immagini o domande di follow-up in qualsiasi momento. Questo permette potenti flussi di lavoro per l’analisi iterativa delle immagini, il confronto o la combinazione di elementi visivi con altre conoscenze.

Chiedi a Claude di confrontare due immagini, poi fai una domanda di follow-up confrontando le prime immagini con due nuove immagini.

Ruolo	Contenuto
Utente	Immagine 1: [Immagine 1] Immagine 2: [Immagine 2] Come sono diverse queste immagini?
Assistente	[Risposta di Claude]
Utente	Immagine 1: [Immagine 3] Immagine 2: [Immagine 4] Queste immagini sono simili alle prime due?
Assistente	[Risposta di Claude]

Quando si utilizza l’API, basta inserire nuove immagini nell’array di Messages nel ruolo user come parte di qualsiasi struttura standard di conversazione a più turni.

Limitazioni

Mentre le capacità di comprensione delle immagini di Claude sono all’avanguardia, ci sono alcune limitazioni da tenere presente:

Identificazione delle persone: Claude non può essere utilizzato per identificare (cioè, nominare) persone nelle immagini e si rifiuterà di farlo.
Accuratezza: Claude potrebbe allucinare o commettere errori nell’interpretare immagini di bassa qualità, ruotate o molto piccole sotto i 200 pixel.
Ragionamento spaziale: Le capacità di ragionamento spaziale di Claude sono limitate. Potrebbe avere difficoltà con compiti che richiedono localizzazione precisa o layout, come leggere un quadrante di orologio analogico o descrivere posizioni esatte di 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 dall’IA: Claude non sa se un’immagine è generata dall’IA e potrebbe essere scorretto se gli viene chiesto. Non fare affidamento su di esso per rilevare immagini false o sintetiche.
Contenuti inappropriati: Claude non elaborerà immagini inappropriate o esplicite che violano la nostra Politica di Utilizzo Accettabile.
Applicazioni sanitarie: Mentre Claude può analizzare immagini mediche generali, non è progettato per interpretare scansioni diagnostiche complesse come TC o RMN. Le uscite di Claude non dovrebbero essere considerate un sostituto del parere medico professionale o della diagnosi.

Rivedi sempre attentamente e verifica le interpretazioni delle immagini di Claude, specialmente per casi d’uso ad alto rischio. Non utilizzare Claude per compiti che richiedono precisione perfetta o analisi di immagini sensibili senza supervisione umana.

FAQ

Quali tipi di file immagine supporta Claude?

Claude può leggere URL di immagini?

Sì, Claude può ora elaborare immagini da URL con i nostri blocchi di origine immagine URL nell’API. Basta utilizzare il tipo di origine “url” invece di “base64” nelle tue richieste API. Esempio:

{
  "type": "image",
  "source": {
    "type": "url",
    "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
  }
}

C'è un limite alla dimensione del file immagine che posso caricare?

Quante immagini posso includere in una richiesta?

Claude legge i metadati delle immagini?

Posso eliminare le immagini che ho caricato?

Dove posso trovare dettagli sulla privacy dei dati per i caricamenti di immagini?

Cosa fare se l'interpretazione dell'immagine di Claude sembra sbagliata?

Claude può generare o modificare immagini?

Approfondisci la visione

Pronto per iniziare a costruire con le immagini usando Claude? Ecco alcune risorse utili:

Ricettario multimodale: Questo ricettario ha suggerimenti su come iniziare con le immagini e tecniche delle migliori pratiche per garantire le prestazioni di massima qualità con le immagini. Vedi come puoi efficacemente dare prompt a Claude con le immagini per svolgere compiti come interpretare e analizzare grafici o estrarre contenuti da moduli.
Riferimento API: Visita la nostra documentazione per l’API Messages, inclusi esempi di chiamate API che coinvolgono immagini.

Se hai altre domande, non esitare a contattare il nostro team di supporto. Puoi anche unirti alla nostra community di sviluppatori per connetterti con altri creatori e ottenere aiuto dagli esperti di Anthropic.

Primi passi

Esplora funzionalità

Modelli e prezzi

Testa e valuta

Centro legale

Scopri Claude

Componenti dell'agente

Come utilizzare la visione

Prima di caricare

Nozioni di base e limiti

Valutare la dimensione dell’immagine

Calcolare i costi delle immagini

Garantire la qualità dell’immagine

Esempi di prompt

Informazioni sugli esempi di prompt

Esempio di immagine codificata in base64

Esempio di immagine basata su URL

Limitazioni

FAQ

Approfondisci la visione

Primi passi

Esplora funzionalità

Modelli e prezzi

Testa e valuta

Centro legale

Scopri Claude

Componenti dell'agente

​Come utilizzare la visione

​Prima di caricare

​Nozioni di base e limiti

​Valutare la dimensione dell’immagine

​Calcolare i costi delle immagini

​Garantire la qualità dell’immagine

​Esempi di prompt

​Informazioni sugli esempi di prompt

​Esempio di immagine codificata in base64

​Esempio di immagine basata su URL

​Limitazioni

​FAQ

​Approfondisci la visione

Come utilizzare la visione

Prima di caricare

Nozioni di base e limiti

Valutare la dimensione dell’immagine

Calcolare i costi delle immagini

Garantire la qualità dell’immagine

Esempi di prompt

Informazioni sugli esempi di prompt

Esempio di immagine codificata in base64

Esempio di immagine basata su URL

Limitazioni

FAQ

Approfondisci la visione