Início Rápido: Usar operações síncronas de Compreensão de Conteúdo

As operações síncronas funcionam melhor para cenários interativos que precisam de conteúdo extraído imediatamente ou que desejam evitar o armazenamento temporário do lado do serviço durante o processamento. Essas operações processam a entrada na memória e retornam conteúdo estruturado diretamente na resposta. Você não envia uma solicitação separada para verificar o resultado. Nesta versão prévia pública, as operações síncronas estão disponíveis para os analisadores e prebuilt-layout analisadoresprebuilt-read.

As operações síncronas dão suporte aos mesmos formatos de arquivo de documento que operações assíncronas. Para obter os limites de tamanho do arquivo, página, caractere e intervalo de páginas, consulte os limites de serviço de Compreensão de Conteúdo.

Pré-requisitos

  • Uma assinatura de Azure ativa. Se você não tiver uma conta Azure, criar uma gratuitamente.
  • Um recurso do Microsoft Foundry em uma região com suporte. Para criar o recurso, você precisa da função Colaborador ou superior na assinatura de destino ou no grupo de recursos.
  • cURL instalado para seu ambiente de desenvolvimento.

Este início rápido mostra como usar operações síncronas de Leitura e Layout na API REST de Compreensão de Conteúdo para extrair conteúdo estruturado de pequenos documentos e imagens. Os prebuilt-read analisadores e os prebuilt-layout analisadores dão suporte a duas operações síncronas:

  • analyzeInline usa uma URL como conteúdo de entrada.
  • analyzeBinaryInline usa um arquivo binário como conteúdo de entrada.

Extrair texto de uma imagem com Leitura

A solicitação a seguir envia uma imagem como dados binários para a operação de leitura síncrona (prebuilt-read:analyzeBinaryInline). Substitua {your-resource-endpoint}, {your-subscription-key}e o caminho do arquivo local por seus valores.

curl --request POST \
  --url 'https://{your-resource-endpoint}/contentunderstanding/analyzers/prebuilt-read:analyzeBinaryInline?api-version=2026-06-01-preview' \
  --header 'Content-Type: application/octet-stream' \
  --header 'Ocp-Apim-Subscription-Key: {your-subscription-key}' \
  --data-binary '@D:\\Demo\\InsuranceCard.png'

A resposta contém as informações de texto e localização extraídas da imagem. Como essa é uma operação síncrona, a resposta contém o resultado da análise diretamente. Você não precisa copiar um Operation-Location valor ou sondagem para obter um resultado.

Para obter mais informações, consulte Analisadores de Conteúdo – Analisar Binário.

Extrair estrutura de documentos com Layout

A solicitação a seguir envia uma URL de documento para a operação layout síncrono. Substitua {your-resource-endpoint} e {your-subscription-key} por seus valores. A URL deve estar acessível ao recurso de Compreensão de Conteúdo.

curl --request POST \
  --url 'https://{your-resource-endpoint}/contentunderstanding/analyzers/prebuilt-layout:analyzeInline?api-version=2026-06-01-preview' \
  --header 'Content-Type: application/json' \
  --header 'Ocp-Apim-Subscription-Key: {your-subscription-key}' \
  --data '{
    "inputs": [
      {
        "url": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/rest-api/layout.png"
      }
    ]
  }'

A resposta contém o conteúdo extraído e a estrutura do documento, como tabelas, seções, figuras, formatação, hiperlinks e assinaturas quando há suporte. A resposta também inclui informações de uso para a operação.

Para obter mais informações, consulte Analisadores de Conteúdo – Analisar.

Escolher entre operações síncronas e assíncronas

Use operações síncronas quando seu aplicativo precisar do resultado imediatamente, a entrada se ajustar dentro dos limites síncronos ou processar documentos na memória é importante para seu cenário. Use operações assíncronas para entradas maiores ou análise de execução mais longa. Para obter um exemplo assíncrono, consulte Início Rápido: Usar a API REST de Compreensão de Conteúdo.

Próximas Etapas 

  • Last updated on