Visione

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

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

Calcola i costi delle immagini

Ogni immagine che includi in una richiesta a Claude conta verso l'utilizzo dei tuoi 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 ha bisogno di essere ridimensionata, puoi stimare il numero di token utilizzati attraverso questo algoritmo: tokens = (width px * height px)/750

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

Garantire la qualità dell'immagine

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

• Formato immagine: Utilizza un formato immagine supportato: JPEG, PNG, GIF o WebP.
• Chiarezza 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 prompt che funzionano bene per le interazioni basate su testo con Claude possono essere applicate anche ai prompt basati su immagini.

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

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 tre modi:

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)

Gli esempi di prompt codificati in base64 utilizzano queste variabili:

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

Esempio di immagine codificata in base64

Esempio di immagine basata su URL

Esempio di immagine dell'API Files

Per le immagini che utilizzerai ripetutamente o quando vuoi evitare il sovraccarico di codifica, utilizza l'API Files:

Vedi Esempi dell'API Messages per ulteriori esempi di codice e dettagli dei parametri.

Limitazioni

Sebbene le capacità di comprensione delle immagini di Claude siano all'avanguardia, ci sono alcune limitazioni di cui essere consapevoli:

• Identificazione di persone: Claude non può essere utilizzato per identificare (cioè nominare) persone nelle immagini e rifiuterà di farlo.
• Precisione: Claude può allucinare o fare 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. Potrebbe avere difficoltà con compiti che richiedono una localizzazione precisa o layout, come leggere il quadrante di un orologio analogico o descrivere le posizioni esatte dei pezzi degli scacchi.
• Conteggio: Claude può fornire conteggi approssimativi di oggetti in un'immagine ma potrebbe non essere sempre precisamente accurato, specialmente con grandi numeri di piccoli oggetti.
• Immagini generate dall'IA: Claude non sa se un'immagine è generata dall'IA e potrebbe essere impreciso se gli viene chiesto. Non fare affidamento su di esso per rilevare immagini false o sintetiche.
• Contenuto inappropriato: Claude non elaborerà immagini inappropriate o esplicite che violano la nostra Politica di utilizzo accettabile.
• Applicazioni sanitarie: Sebbene Claude possa analizzare immagini mediche generali, non è progettato per interpretare scansioni diagnostiche complesse come TC o risonanze magnetiche. Gli output di Claude non devono essere considerati un sostituto della consulenza medica professionale o della diagnosi.

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

Domande Frequenti

Approfondisci la visione

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

• Multimodal cookbook: Questo cookbook contiene suggerimenti su come iniziare con le immagini e tecniche di best practice per garantire le migliori prestazioni con le immagini. Scopri come puoi richiedere efficacemente a Claude con immagini per eseguire attività come interpretare e analizzare grafici o estrarre contenuto dai moduli.
• Riferimento API: Visita la nostra documentazione per l'API Messages, inclusi gli 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 comunità di sviluppatori per connetterti con altri creatori e ottenere aiuto dagli esperti di Anthropic.