Home / Documentazione / Visione e input di immagini

Visione e input di immagini

Invia immagini ai modelli multimodali: codifica, limiti di dimensione e costi.

I modelli Claude e Gemini accettano immagini insieme al testo. Le immagini sono blocchi di contenuto all'interno di un normale messaggio.

Immagine Base64

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image", "source": {
        "type": "base64",
        "media_type": "image/png",
        "data": "iVBORw0KGgoAAAANSUhEUg..."
      }},
      {"type": "text", "text": "What does this chart show?"}
    ]
  }]
}

Python

import base64, anthropic

img = base64.standard_b64encode(open(class="s">"chart.png", class="s">"rb").read()).decode()

client = anthropic.Anthropic(api_key=class="s">"sk-your-key", base_url=class="s">"https://aiprimetech.io")
msg = client.messages.create(
    model=class="s">"claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{class="s">"role": class="s">"user", class="s">"content": [
        {class="s">"type": class="s">"image", class="s">"source": {class="s">"type": class="s">"base64",
         class="s">"media_type": class="s">"image/png", class="s">"data": img}},
        {class="s">"type": class="s">"text", class="s">"text": class="s">"What does this chart show?"},
    ]}],
)
print(msg.content[0].text)

Limiti pratici

VincoloIndicazioni
FormatiPNG, JPEG, GIF e WebP
RisoluzioneLe immagini molto grandi vengono ridimensionate a monte. Ridimensionarle a circa 1500px sul lato lungo prima dell'invio consente di risparmiare token senza perdita di qualità.
CostoLe immagini vengono fatturate come token di input, in modo approssimativamente proporzionale all'area. Uno screenshot a pagina intera può costare più di una pagina di testo.
Immagini multipleSono consentiti più blocchi di immagini per messaggio; ciascuno viene fatturato.
In un ciclo di un agente, le immagini vengono inviate nuovamente con la cronologia a ogni turno, come qualsiasi altro contenuto. Rimuovile dalla trascrizione dopo che sono state descritte, altrimenti pagherai ripetutamente per lo stesso screenshot.