Inicio rápido: Uso de operaciones de comprensión de contenido sincrónica

Las operaciones sincrónicas funcionan mejor para escenarios interactivos que necesitan contenido extraído inmediatamente o quieren evitar el almacenamiento temporal del lado del servicio durante el procesamiento. Estas operaciones procesan la entrada en memoria y devuelven contenido estructurado directamente en la respuesta. No envía una solicitud independiente para comprobar el resultado. En esta versión preliminar pública, las operaciones sincrónicas están disponibles para los prebuilt-read analizadores y prebuilt-layout .

Las operaciones sincrónicas admiten los mismos formatos de archivo de documento que las operaciones asincrónicas. Para conocer los límites de tamaño de archivo, página, caracteres y intervalos de páginas, consulte Límites del servicio Content Understanding.

Prerrequisitos

  • Una suscripción de Azure activa. Si no tiene una cuenta de Azure, cree una gratuita.
  • Un recurso de Microsoft Foundry en una región compatible. Para crear el recurso, necesita el rol de Colaborador o superior en la suscripción de destino o en el grupo de recursos.
  • cURL instalado para el entorno de desarrollo.

En este inicio rápido se muestra cómo usar operaciones de lectura y diseño sincrónicas en la API REST content Understanding para extraer contenido estructurado de documentos e imágenes pequeños. Los prebuilt-read analizadores y prebuilt-layout admiten dos operaciones sincrónicas:

  • analyzeInline toma una dirección URL como contenido de entrada.
  • analyzeBinaryInline toma un archivo binario como contenido de entrada.

Extracción de texto de una imagen con lectura

La siguiente solicitud envía una imagen como datos binarios a la operación de lectura sincrónica (prebuilt-read:analyzeBinaryInline). Reemplace {your-resource-endpoint}, {your-subscription-key}y la ruta de acceso del archivo local por los 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'

La respuesta contiene la información de ubicación y texto extraído de la imagen. Dado que se trata de una operación sincrónica, la respuesta contiene directamente el resultado del análisis. No es necesario copiar un Operation-Location valor ni sondear un resultado.

Para obtener más información, vea Analizadores de contenido: análisis binario.

Extracción de la estructura del documento con diseño

La siguiente solicitud envía una dirección URL del documento a la operación de diseño sincrónica. Reemplace {your-resource-endpoint} y {your-subscription-key} con sus valores. La dirección URL debe ser accesible para el recurso Content Understanding.

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"
      }
    ]
  }'

La respuesta contiene el contenido extraído y la estructura del documento, como tablas, secciones, ilustraciones, formato, hipervínculos y firmas cuando se admiten. La respuesta también incluye información de uso para la operación.

Para obtener más información, consulte Analizadores de contenido: análisis.

Elegir entre operaciones sincrónicas y asincrónicas

Use operaciones sincrónicas cuando la aplicación necesite el resultado inmediatamente, la entrada se ajusta a los límites sincrónicos o el procesamiento de documentos en memoria es importante para su escenario. Use operaciones asincrónicas para entradas más grandes o análisis de ejecución más larga. Para obtener un ejemplo asincrónico, consulte Inicio rápido: Uso de la API REST de Content Understanding.

Pasos siguientes

  • Last updated on