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

As operações síncronas funcionam melhor para cenários interativos que necessitam de conteúdo extraído imediatamente ou que pretendem evitar armazenamento temporário do lado do serviço durante o processamento. Estas operações processam a entrada na memória e devolvem conteúdo estruturado diretamente na resposta. Não se envia um pedido separado para verificar o resultado. Nesta pré-visualização pública, estão disponíveis operações síncronas para os prebuilt-read analisadores e prebuilt-layout .

As operações síncronas suportam os mesmos formatos de ficheiros de documentos que as operações assíncronas. Para limites de tamanho de ficheiro, página, carácter e intervalo de página, consulte Limites de serviço de Compreensão de Conteúdo.

Pré-requisitos

  • Uma assinatura ativa do Azure. Se você não tiver uma conta do Azure, crie uma gratuitamente.
  • Um recurso Microsoft Foundry numa região suportada . Para criar o recurso, precisa do papel de Contribuidor ou superior na subscrição ou grupo de recursos alvo.
  • cURL instalado para o teu ambiente de desenvolvimento.

Este quickstart 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 documentos e imagens pequenas. Os prebuilt-read analisadores e prebuilt-layout suportam duas operações síncronas:

  • analyzeInline aceita um URL como conteúdo de entrada.
  • analyzeBinaryInline aceita um ficheiro binário como conteúdo de entrada.

Extrair texto de uma imagem com Read

O pedido seguinte 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 local do ficheiro pelos 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 o texto extraído e a informação de localização da imagem. Como esta é uma operação síncrona, a resposta contém diretamente o resultado da análise. Não precisas de copiar um Operation-Location valor ou inquirir para obter um resultado.

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

Extrair estrutura do documento com Layout

O pedido seguinte envia um URL de documento para a operação síncrona de Layout. Substitui {your-resource-endpoint} e {your-subscription-key} pelos teus 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, secções, figuras, formatação, hiperligações e assinaturas quando suportadas. A resposta inclui também informações de utilização para a operação.

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

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

Use operações síncronas quando a sua aplicação precisar do resultado imediatamente, quando a entrada se encaixa dentro dos limites síncronos, ou quando processar documentos na memória é importante para o seu cenário. Use operações assíncronas para entradas maiores ou análises de longa duração. Para um exemplo assíncrono, veja Quickstart: Use a API REST de Compreensão de Conteúdo.

Passos seguintes

  • Last updated on