Visão

Este guia descreve como trabalhar com imagens no Claude, incluindo melhores práticas, exemplos de código e limitações a serem consideradas.

Como usar visão

Use as capacidades de visão do Claude através de:

claude.ai. Carregue uma imagem como faria com um arquivo, ou arraste e solte uma imagem diretamente na janela de chat.
O Console Workbench. Um botão para adicionar imagens aparece no canto superior direito de cada bloco de mensagem do Usuário.
Requisição de API. Veja os exemplos neste guia.

Antes de fazer upload

Noções básicas e limites

Você pode incluir múltiplas imagens em uma única requisição (até 20 para claude.ai e 100 para requisições de API). Claude analisará todas as imagens fornecidas ao formular sua resposta. Isso pode ser útil para comparar ou contrastar imagens.

Se você enviar uma imagem maior que 8000x8000 px, ela será rejeitada. Se você enviar mais de 20 imagens em uma requisição de API, este limite é 2000x2000 px.

Embora a API suporte 100 imagens por requisição, há um limite de tamanho de requisição de 32MB para endpoints padrão.

Avaliar tamanho da imagem

Para desempenho ideal, recomendamos redimensionar imagens antes de fazer upload se forem muito grandes. Se a borda longa da sua imagem tiver mais de 1568 pixels, ou sua imagem tiver mais de ~1.600 tokens, ela será primeiro reduzida, preservando a proporção de aspecto, até estar dentro dos limites de tamanho.

Se sua imagem de entrada for muito grande e precisar ser redimensionada, isso aumentará a latência do time-to-first-token, sem lhe dar nenhum desempenho adicional do modelo. Imagens muito pequenas com menos de 200 pixels em qualquer borda podem degradar o desempenho.

Para melhorar o time-to-first-token, recomendamos redimensionar imagens para no máximo 1,15 megapixels (e dentro de 1568 pixels em ambas as dimensões).

Aqui está uma tabela dos tamanhos máximos de imagem aceitos pela nossa API que não serão redimensionados para proporções de aspecto comuns. Com Claude Sonnet 4.5, essas imagens usam aproximadamente 1.600 tokens e cerca de $4,80/1K imagens.

Proporção de aspecto	Tamanho da imagem
1:1	1092x1092 px
3:4	951x1268 px
2:3	896x1344 px
9:16	819x1456 px
1:2	784x1568 px

Calcular custos de imagem

Cada imagem que você inclui em uma requisição ao Claude conta para seu uso de tokens. Para calcular o custo aproximado, multiplique o número aproximado de tokens de imagem pelo preço por token do modelo que você está usando.

Se sua imagem não precisar ser redimensionada, você pode estimar o número de tokens usados através deste algoritmo: tokens = (width px * height px)/750

Aqui estão exemplos de tokenização aproximada e custos para diferentes tamanhos de imagem dentro das restrições de tamanho da nossa API com base no preço por token do Claude Sonnet 4.5 de $3 por milhão de tokens de entrada:

Tamanho da imagem	# de Tokens	Custo / imagem	Custo / 1K imagens
200x200 px(0,04 megapixels)	~54	~$0,00016	~$0,16
1000x1000 px(1 megapixel)	~1334	~$0,004	~$4,00
1092x1092 px(1,19 megapixels)	~1590	~$0,0048	~$4,80

Garantindo qualidade de imagem

Ao fornecer imagens ao Claude, tenha em mente o seguinte para melhores resultados:

Formato de imagem: Use um formato de imagem suportado: JPEG, PNG, GIF ou WebP.
Clareza da imagem: Certifique-se de que as imagens são claras e não muito desfocadas ou pixeladas.
Texto: Se a imagem contiver texto importante, certifique-se de que é legível e não muito pequeno. Evite cortar o contexto visual chave apenas para ampliar o texto.

Exemplos de prompt

Muitas das técnicas de prompting que funcionam bem para interações baseadas em texto com Claude também podem ser aplicadas a prompts baseados em imagem.

Estes exemplos demonstram estruturas de prompt de melhores práticas envolvendo imagens.

Assim como com posicionamento de documento-consulta, Claude funciona melhor quando as imagens vêm antes do texto. Imagens colocadas após texto ou interpoladas com texto ainda funcionarão bem, mas se seu caso de uso permitir, recomendamos uma estrutura imagem-depois-texto.

Sobre os exemplos de prompt

Os exemplos a seguir demonstram como usar as capacidades de visão do Claude usando várias linguagens de programação e abordagens. Você pode fornecer imagens ao Claude de três maneiras:

Como uma imagem codificada em base64 em blocos de conteúdo image
Como uma referência de URL para uma imagem hospedada online
Usando a Files API (fazer upload uma vez, usar múltiplas vezes)

Os prompts de exemplo base64 usam estas variáveis:

Abaixo estão exemplos de como incluir imagens em uma requisição da Messages API usando imagens codificadas em base64 e referências de URL:

Exemplo de imagem codificada em base64

Exemplo de imagem baseada em URL

Exemplo de imagem da Files API

Para imagens que você usará repetidamente ou quando quiser evitar sobrecarga de codificação, use a Files API:

Veja exemplos da Messages API para mais código de exemplo e detalhes de parâmetros.

Limitações

Embora as capacidades de compreensão de imagem do Claude sejam de ponta, há algumas limitações a serem consideradas:

Identificação de pessoas: Claude não pode ser usado para identificar (ou seja, nomear) pessoas em imagens e se recusará a fazer isso.
Precisão: Claude pode alucinar ou cometer erros ao interpretar imagens de baixa qualidade, rotacionadas ou muito pequenas com menos de 200 pixels.
Raciocínio espacial: As capacidades de raciocínio espacial do Claude são limitadas. Pode ter dificuldade com tarefas que exigem localização precisa ou layouts, como ler o rosto de um relógio analógico ou descrever posições exatas de peças de xadrez.
Contagem: Claude pode dar contagens aproximadas de objetos em uma imagem, mas pode não ser sempre precisamente preciso, especialmente com grandes números de objetos pequenos.
Imagens geradas por IA: Claude não sabe se uma imagem é gerada por IA e pode estar incorreto se perguntado. Não confie nele para detectar imagens falsas ou sintéticas.
Conteúdo inadequado: Claude não processará imagens inadequadas ou explícitas que violem nossa Política de Uso Aceitável.
Aplicações de saúde: Embora Claude possa analisar imagens médicas gerais, não foi projetado para interpretar varreduras diagnósticas complexas como CTs ou MRIs. Os resultados do Claude não devem ser considerados um substituto para aconselhamento ou diagnóstico médico profissional.

Sempre revise e verifique cuidadosamente as interpretações de imagem do Claude, especialmente para casos de uso de alto risco. Não use Claude para tarefas que exigem precisão perfeita ou análise de imagem sensível sem supervisão humana.

Perguntas Frequentes

Aprofunde-se na visão

Pronto para começar a construir com imagens usando Claude? Aqui estão alguns recursos úteis:

Multimodal cookbook: Este cookbook tem dicas sobre como começar com imagens e técnicas de melhores práticas para garantir o melhor desempenho com imagens. Veja como você pode fazer prompt efetivamente do Claude com imagens para realizar tarefas como interpretar e analisar gráficos ou extrair conteúdo de formulários.
Referência de API: Visite nossa documentação para a Messages API, incluindo exemplos de chamadas de API envolvendo imagens.

Se você tiver outras dúvidas, sinta-se à vontade para entrar em contato com nossa equipe de suporte. Você também pode se juntar à nossa comunidade de desenvolvedores para se conectar com outros criadores e obter ajuda de especialistas da Anthropic.

    # Para imagens baseadas em URL, você pode usar a URL diretamente em sua requisição JSON
    
    # Para imagens codificadas em base64, você precisa primeiro codificar a imagem
    # Exemplo de como codificar uma imagem para base64 em bash:
    BASE64_IMAGE_DATA=$(curl -s "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg" | base64)
    
    # Os dados codificados agora podem ser usados em suas chamadas de API

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-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "base64",
              "media_type": "image/jpeg",
              "data": "'"$BASE64_IMAGE_DATA"'"
            }
          },
          {
            "type": "text",
            "text": "Describe this image."
          }
        ]
      }
    ]
  }'

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-5",
    "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 this image."
          }
        ]
      }
    ]
  }'

# Primeiro, faça upload de sua imagem para a Files API
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 "[email protected]"

# Então use o file_id retornado em sua mensagem
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-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "file",
              "file_id": "file_abc123"
            }
          },
          {
            "type": "text",
            "text": "Describe this image."
          }
        ]
      }
    ]
  }'

Como usar visão

Antes de fazer upload

Noções básicas e limites

Avaliar tamanho da imagem

Calcular custos de imagem

Garantindo qualidade de imagem

Exemplos de prompt

Sobre os exemplos de prompt

Exemplo de imagem codificada em base64

Exemplo de imagem baseada em URL

Exemplo de imagem da Files API

Exemplo: Uma imagem

Limitações

Perguntas Frequentes

Quais tipos de arquivo de imagem Claude suporta?

Claude pode ler URLs de imagens?

Aprofunde-se na visão

Exemplo: Múltiplas imagens

Exemplo: Múltiplas imagens com um prompt de sistema

Exemplo: Quatro imagens em dois turnos de conversa

Existe um limite para o tamanho do arquivo de imagem que posso fazer upload?

Quantas imagens posso incluir em uma solicitação?

Claude lê metadados de imagem?

Posso deletar imagens que fiz upload?

Onde posso encontrar detalhes sobre privacidade de dados para uploads de imagem?

E se a interpretação de imagem do Claude parecer errada?

Claude pode gerar ou editar imagens?