Visión

​

Cómo usar la visión

• claude.ai. Sube una imagen como lo harías con un archivo, o arrastra y suelta una imagen directamente en la ventana de chat.
• El Console Workbench. Si seleccionas un modelo que acepta imágenes (solo modelos Claude 3 y 4), aparece un botón para agregar imágenes en la parte superior derecha de cada bloque de mensaje de Usuario.
• Solicitud API. Ve los ejemplos en esta guía.

​

Antes de subir

​

Conceptos básicos y límites

​

Evaluar el tamaño de imagen

​

Calcular costos de imagen

​

Asegurar la calidad de imagen

• Formato de imagen: Usa un formato de imagen soportado: JPEG, PNG, GIF, o WebP.
• Claridad de imagen: Asegúrate de que las imágenes sean claras y no demasiado borrosas o pixeladas.
• Texto: Si la imagen contiene texto importante, asegúrate de que sea legible y no demasiado pequeño. Evita recortar contexto visual clave solo para agrandar el texto.

​

Ejemplos de prompts

​

Acerca de los ejemplos de prompts

1. Como una imagen codificada en base64 en bloques de contenido image
2. Como una referencia URL a una imagen alojada en línea
3. Usando la API de Archivos (sube una vez, usa múltiples veces)

    # Para imágenes basadas en URL, puedes usar la URL directamente en tu solicitud JSON
    
    # Para imágenes codificadas en base64, necesitas primero codificar la imagen
    # Ejemplo de cómo codificar una imagen a base64 en bash:
    BASE64_IMAGE_DATA=$(curl -s "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg" | base64)
    
    # Los datos codificados ahora pueden ser usados en tus llamadas API

​

Ejemplo de imagen codificada en 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": "Describe esta imagen."
          }
        ]
      }
    ]
  }'

​

Ejemplo de imagen basada en 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": "Describe esta imagen."
          }
        ]
      }
    ]
  }'

​

Ejemplo de imagen de la API de Archivos

# Primero, sube tu imagen a la API de Archivos
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"

# Luego usa el file_id devuelto en tu mensaje
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": "Describe esta imagen."
          }
        ]
      }
    ]
  }'

​

Limitaciones

• Identificación de personas: Claude no puede ser usado para identificar (es decir, nombrar) personas en imágenes y se negará a hacerlo.
• Precisión: Claude puede alucinar o cometer errores al interpretar imágenes de baja calidad, rotadas, o muy pequeñas de menos de 200 píxeles.
• Razonamiento espacial: Las habilidades de razonamiento espacial de Claude son limitadas. Puede tener dificultades con tareas que requieren localización precisa o diseños, como leer la cara de un reloj analógico o describir posiciones exactas de piezas de ajedrez.
• Conteo: Claude puede dar conteos aproximados de objetos en una imagen pero puede no ser siempre precisamente exacto, especialmente con grandes números de objetos pequeños.
• Imágenes generadas por IA: Claude no sabe si una imagen es generada por IA y puede ser incorrecto si se le pregunta. No confíes en él para detectar imágenes falsas o sintéticas.
• Contenido inapropiado: Claude no procesará imágenes inapropiadas o explícitas que violen nuestra Política de Uso Aceptable.
• Aplicaciones de salud: Aunque Claude puede analizar imágenes médicas generales, no está diseñado para interpretar escaneos diagnósticos complejos como TCs o RMs. Las salidas de Claude no deben considerarse un sustituto del consejo médico profesional o diagnóstico.

​

FAQ

​

Profundiza en la visión

• Cookbook multimodal: Este cookbook tiene consejos sobre empezar con imágenes y técnicas de mejores prácticas para asegurar el rendimiento de más alta calidad con imágenes. Ve cómo puedes efectivamente hacer prompts a Claude con imágenes para llevar a cabo tareas como interpretar y analizar gráficos o extraer contenido de formularios.
• Referencia API: Visita nuestra documentación para la API de Mensajes, incluyendo llamadas API de ejemplo que involucran imágenes.