Inicio / Documentación / Visión y entrada de imágenes

Visión y entrada de imágenes

Envía imágenes a modelos multimodales: codificación, límites de tamaño y coste.

Los modelos Claude y Gemini aceptan imágenes junto con texto. Las imágenes son bloques de contenido dentro de un mensaje normal.

Imagen en 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)

Límites prácticos

RestricciónRecomendaciones
FormatosPNG, JPEG, GIF y WebP
ResoluciónLas imágenes muy grandes se reducen antes de llegar al modelo. Redimensionarlas a unos 1500 px en su lado más largo antes de enviarlas ahorra tokens sin pérdida de calidad.
CosteLas imágenes se facturan como tokens de entrada, en una cantidad aproximadamente proporcional a su área. Una captura de pantalla de página completa puede costar más que una página de texto.
Varias imágenesSe permiten varios bloques de imagen por mensaje; cada uno se factura.
En un bucle de agente, las imágenes se vuelven a enviar con el historial en cada turno, como cualquier otro contenido. Elimínalas del historial de la conversación una vez descritas; de lo contrario, pagarás repetidamente por una misma captura de pantalla.