Schnellstart: Verwenden synchroner Inhaltsverständnisvorgänge

Synchrone Vorgänge eignen sich am besten für interaktive Szenarien, in denen Inhalte sofort extrahiert werden müssen oder während der Verarbeitung temporären dienstseitigen Speicher vermieden werden sollen. Diese Vorgänge verarbeiten die Eingabe im Arbeitsspeicher und geben strukturierte Inhalte direkt in der Antwort zurück. Sie senden keine separate Anforderung, um nach dem Ergebnis zu suchen. In dieser öffentlichen Vorschau stehen synchrone Vorgänge für die Analyse und prebuilt-layout die prebuilt-read Analyse zur Verfügung.

Synchrone Vorgänge unterstützen dieselben Dokumentdateiformate wie asynchrone Vorgänge. Informationen zu Dateigrößen-, Seiten-, Zeichen- und Seitenbereichsbeschränkungen finden Sie unter Grenzwerte für den Inhaltsverständnisdienst.

Voraussetzungen

In dieser Schnellstartanleitung wird gezeigt, wie Sie synchrone Lese- und Layoutvorgänge in der REST-API für Inhaltsverständnis verwenden, um strukturierte Inhalte aus kleinen Dokumenten und Bildern zu extrahieren. Die prebuilt-read Analysatoren prebuilt-layout unterstützen zwei synchrone Vorgänge:

  • analyzeInline akzeptiert eine URL als Eingabeinhalt.
  • analyzeBinaryInline akzeptiert eine Binärdatei als Eingabeinhalt.

Extrahieren von Text aus einem Bild mit "Lesen"

Die folgende Anforderung sendet ein Bild als Binärdaten an den synchronen Lesevorgang (prebuilt-read:analyzeBinaryInline). Ersetzen Sie {your-resource-endpoint}, , {your-subscription-key}und den lokalen Dateipfad durch Ihre Werte.

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'

Die Antwort enthält die extrahierten Text- und Positionsinformationen aus dem Bild. Da es sich um einen synchronen Vorgang handelt, enthält die Antwort das Analyseergebnis direkt. Sie müssen keinen Wert oder eine Abfrage für ein Ergebnis kopieren Operation-Location .

Weitere Informationen finden Sie unter Content Analyzers - Analyze Binary.

Extrahieren der Dokumentstruktur mit Layout

Die folgende Anforderung sendet eine Dokument-URL an den synchronen Layoutvorgang. Ersetzen Sie {your-resource-endpoint} und {your-subscription-key} durch Ihre eigenen Werte. Auf die URL muss für die Inhaltsverständnisressource zugegriffen werden kann.

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

Die Antwort enthält den extrahierten Inhalt und die Dokumentstruktur, z. B. Tabellen, Abschnitte, Abbildungen, Formatierung, Links und Signaturen, wenn unterstützt. Die Antwort enthält auch Nutzungsinformationen für den Vorgang.

Weitere Informationen finden Sie unter Inhaltsanalyse – Analysieren.

Auswählen zwischen synchronen und asynchronen Vorgängen

Verwenden Sie synchrone Vorgänge, wenn Ihre Anwendung das Ergebnis sofort benötigt, die Eingabe in die synchronen Grenzwerte passt, oder die Verarbeitung von Dokumenten im Arbeitsspeicher ist für Ihr Szenario wichtig. Verwenden Sie asynchrone Vorgänge für größere Eingaben oder eine längere Analyse. Ein asynchrones Beispiel finden Sie in der Schnellstartanleitung: Verwenden der REST-API für Inhaltsverständnis.

Nächste Schritte

  • Last updated on