O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Configurar um projeto de reconhecimento de caracteres

O reconhecimento óptico de caracteres (OCR) no Google Distributed Cloud (GDC) com isolamento físico permite detectar e extrair texto de imagens e documentos nos seus aplicativos. Depois de criar um projeto e solicitar papéis de desenvolvedor, ative a API OCR no console do GDC para conferir o status do serviço e o endpoint. Em seguida, instale a biblioteca de cliente do Python, defina variáveis de ambiente e use a CLI gdcloud para configurar contas de serviço e autenticar solicitações. Se você não conhece a Vertex AI, consulte Saiba mais sobre os recursos de reconhecimento de caracteres.

Crie um projeto

Criar um projeto de reconhecimento de caracteres na hierarquia de recursos do Distributed Cloud organiza seus recursos de OCR, que incluem colaboradores, APIs ativadas, ferramentas de monitoramento, informações de faturamento, credenciais de autenticação e controles de acesso.

Para criar seu projeto, consulte Configurar um projeto para a Vertex AI. Você precisa do ID do projeto ao fazer chamadas de API.

Solicitar permissões de desenvolvedor

Você precisa ter o papel de desenvolvedor de OCR de IA no seu projeto para acessar recursos de reconhecimento óptico de caracteres e gerar um token de API para autenticação e autorização de solicitações.

Peça ao administrador do IAM do projeto para conceder o papel de desenvolvedor de OCR de IA (ai-ocr-developer) à sua conta de usuário ou de serviço no namespace do projeto. Para mais informações sobre esse papel, consulte Preparar permissões do IAM.

Ativar a API OCR

É necessário ativar a API OCR pré-treinada no projeto. Se ativada, você pode conferir o status do serviço e o endpoint da API OCR pré-treinada.

Instalar bibliotecas de cliente

As bibliotecas de cliente estão disponíveis para a linguagem de programação Python. Recomendamos o uso dessas bibliotecas de cliente para fazer chamadas para a API OCR, porque elas facilitam o acesso às APIs.

O método recomendado para instalar essa biblioteca é em um ambiente virtual, usando venv.

O uso do venv oferece várias vantagens importantes:

Ele cria ambientes Python isolados para hospedar diferentes versões de pacotes.
Ele evita conflitos entre dependências de projetos e instalações em todo o sistema.
Ele permite a instalação de bibliotecas sem precisar de permissões no nível do sistema.

Instale a biblioteca de cliente do OCR e siga estas etapas para garantir que você tenha a versão correta:

Verifique se a biblioteca de cliente do OCR está instalada e consiga o número da versão:
```
pip freeze | grep vision
```
Se a biblioteca de cliente já estiver instalada, você vai receber uma saída semelhante ao exemplo a seguir:
```
google-cloud-vision==3.0.0
```
O número da versão que você receber precisa corresponder à biblioteca de cliente no seguinte endpoint:
```
https://GDC_URL/.well-known/static/client-libraries
```
Substitua GDC_URL pelo URL da sua organização no GDC.
Se os números de versão não forem iguais, desinstale a biblioteca de cliente:
```
pip uninstall google-cloud-vision
```
Se você desinstalou a biblioteca de cliente do OCR, é necessário reinstalá-la especificando o nome de arquivo correspondente ao seu sistema operacional.

Definir as variáveis de ambiente

Depois de instalar a biblioteca de cliente do OCR, você pode interagir com a API usando um script Python.

Se você configurar uma conta de serviço no projeto para fazer chamadas de API autorizadas de maneira programática, poderá definir variáveis de ambiente no script Python para acessar valores como as chaves da conta de serviço durante a execução.

Siga estas etapas para definir as variáveis de ambiente necessárias em um script Python:

Crie um notebook do JupyterLab para interagir com a API pré-treinada de OCR.
Crie um script Python no notebook do JupyterLab.
Adicione o seguinte código ao script Python:
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
Substitua APPLICATION_DEFAULT_CREDENTIALS_FILENAME pelo nome do arquivo JSON que contém as chaves da conta de serviço que você criou no projeto, como my-service-key.json.
Salve o script do Python com um nome, como vision.py.
Execute o script Python para definir as variáveis de ambiente:
```
python SCRIPT_NAME
```
Substitua SCRIPT_NAME pelo nome que você deu ao script do Python, como vision.py.

Configurar a autenticação

Antes de começar a usar a API OCR, é preciso autenticar suas credenciais de cliente e solicitar acesso à conta para os recursos do projeto. Para mais informações, consulte Autenticar solicitações de API.