Delen via


Quickstart: Azure Content Understanding gebruiken in Foundry Tools REST API

In deze quickstart ziet u hoe u de Rest API van Content Understanding gebruikt om gestructureerde gegevens op te halen uit multimodale inhoud in document-, afbeeldings-, audio- en videobestanden.

Vereisten

  • U hebt een actief Azure-abonnement nodig om aan de slag te gaan. Als u geen Azure-account hebt, kunt u er een gratis maken.
  • Zodra u uw Azure-abonnement hebt, maakt u een Microsoft Foundry-resource in Azure Portal. Zorg ervoor dat u deze maakt in een ondersteunde regio.
  • Stel standaardmodelimplementaties in voor uw Content Understanding-resource. Als u de standaardinstellingen instelt, wordt er een verbinding gemaakt met de Foundry-modellen die u gebruikt voor Aanvragen voor Content Understanding. Kies één van de volgende methoden:
    1. Ga naar de pagina Inhoudsbegrip-instellingen
    2. Selecteer de knop + Resource toevoegen in de linkerbovenhoek
    3. Selecteer de Foundry-resource die u wilt gebruiken en klik op Volgende en klik vervolgens op Opslaan
      • Zorg ervoor dat u 'Automatisch implementeren voor vereiste modellen inschakelen als er geen standaardinstellingen beschikbaar zijn' ingeschakeld. Dit zorgt ervoor dat uw resource volledig is ingesteld met de vereiste modellen: GPT-4.1, GPT-4.1-mini en tekst-embedding-3-groot. Voor verschillende vooraf samengestelde analyses zijn verschillende modellen vereist.
    Door deze stappen uit te voeren, stelt u een verbinding in tussen Content Understanding- en Foundry-modellen in uw Foundry-resource.
  • In deze handleiding gebruiken we het opdrachtregelprogramma cURL. Als deze niet is geïnstalleerd, kunt u de juiste versie voor uw ontwikkelomgeving downloaden.

Aan de slag met een vooraf gedefinieerde analyse

Analyses definiëren hoe uw inhoud wordt verwerkt en welke inzichten worden geëxtraheerd. We bieden vooraf samengestelde analyses voor veelvoorkomende gebruiksvoorbeelden . U kunt vooraf gemaakte analyses aanpassen aan uw specifieke behoeften en gebruiksvoorbeelden. In deze quickstart worden vooraf samengestelde facturen, afbeeldingen, audio- en videoanalyses gebruikt om u te helpen aan de slag te gaan.

Een bestand verzenden voor analyse

Voordat u de volgende cURL-opdracht uitvoert, moet u de volgende wijzigingen aanbrengen in de HTTP-aanvraag:

  1. Vervang {endpoint} en {key} door de bijbehorende waarden uit uw Foundry-exemplaar in Azure Portal.

POST-aanvraag

In dit voorbeeld wordt de prebuilt-invoice analyse gebruikt om gestructureerde gegevens uit een factuurdocument te extraheren.

curl -i -X POST "{endpoint}/contentunderstanding/analyzers/prebuilt-invoice:analyze?api-version=2025-11-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
        "inputs":[{"url": "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf"}]
      }'  

POST-antwoord

De antwoordheader bevat een Operation-Location veld dat u gebruikt om de resultaten van de asynchrone analysebewerking op te halen.

HTTP/1.1 202 Accepted
Transfer-Encoding: chunked
Content-Type: application/json
request-id: aaa-bbb-ccc-ddd
x-ms-request-id: aaa-bbb-ccc-ddd
Operation-Location: {endpoint}/contentunderstanding/analyzerResults/{request-id}?api-version=2025-11-01
api-supported-versions: 2024-12-01-preview,2025-05-01-preview,2025-11-01
x-envoy-upstream-service-time: 800
apim-request-id: {request-id}
Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
x-ms-region: West US
Date: Fri, 31 Oct 2025 05:30:17 GMT
Connection: close

Belangrijk

Kopieer de URL van de bewerkingslocatie uit de antwoordheader. In de volgende stap gebruikt u deze URL om de analyseresultaten op te halen.

Analyseresultaat ophalen

Gebruik het Operation-Location van het POSTantwoord en haal het resultaat van de analyse op.

Opmerking

Wanneer u de videoanalyse gebruikt, worden sleutelframes geretourneerd als URL's in het JSON-antwoord (bijvoorbeeld onder result.contents.frames[]).
U kunt deze sleutelframes downloaden met behulp van een standaard HTTP-aanvraag voor elke keyframe-URL GET .
Voorbeeld (Bash):

curl -O "<keyframeUrl>"

Herhaal deze opdracht voor elke keyframe-URL die u wilt opslaan.

GET-aanvraag

curl -i -X GET "{endpoint}/contentunderstanding/analyzerResults/{request-id}?api-version=2025-11-01" \
  -H "Ocp-Apim-Subscription-Key: {key}"

GET-antwoord

Het JSON-antwoord 200 (OK) bevat een status veld dat de status van de bewerking aangeeft. Als de bewerking niet is voltooid, is status of RunningNotStarted. In dergelijke gevallen moet u de GET aanvraag opnieuw verzenden, handmatig of via een script. Wacht een interval van één seconde of meer tussen aanroepen.

{
  "id": "ce05fb5a-579e-4f0b-afb5-3532bcddeaee",
  "status": "Succeeded",
  "result": {
    "analyzerId": "prebuilt-invoice",
    "apiVersion": "2025-11-01",
    "createdAt": "2025-11-13T20:04:55Z",
    "warnings": [],
    "contents": [
      {
        "path": "input1",
        "markdown": "CONTOSO LTD.\n\n\n# INVOICE\n\nContoso Headquarters\n123 456th St\nNew York, NY, 10001\n\nINVOICE: INV-100\n\nINVOICE DATE: 11/15/2019\n\nDUE DATE: 12/15/2019\n\nCUSTOMER NAME: MICROSOFT CORPORATION...",
        "fields": {
          "AmountDue": {
            "type": "object",
            "valueObject": {
              "Amount": {
                "type": "number",
                "valueNumber": 610,
                "spans": [
                  {
                    "offset": 1522,
                    "length": 7
                  }
                ],
                "confidence": 0.773,
                "source": "D(1,7.3628,8.0459,7.9272,8.0459,7.9272,8.2070,7.3628,8.2070)"
              },
              "CurrencyCode": {
                "type": "string",
                "valueString": "USD"
              }
            }
          },
          "BalanceForward": {
            "type": "object",
            "valueObject": {
              "Amount": {
                "type": "number",
                "valueNumber": 500,
                "spans": [
                  {
                    "offset": 1474,
                    "length": 7
                  }
                ],
                "confidence": 0.901,
                "source": "D(1,7.3628,7.7445,7.9278,7.7467,7.9272,7.9092,7.3622,7.9070)"
              },
              "CurrencyCode": {
                "type": "string",
                "valueString": "USD"
              }
            }
          },
          "BillingAddress": {
            "type": "string",
            "valueString": "123 Bill St, Redmond WA, 98052",
            "spans": [
              {
                "offset": 325,
                "length": 12
              },
              "..."
            ],
            "confidence": 0.712,
            "source": "D(1,0.5805,3.9471,1.2858,3.9478,1.2856,4.1115,0.5803,4.1108);..."
          },
          "BillingAddressRecipient": {
            "type": "string",
            "valueString": "Microsoft Finance",
            "spans": [
              {
                "offset": 307,
                "length": 17
              }
            ],
            "confidence": 0.815,
            "source": "D(1,0.5734,3.7392,1.8060,3.7521,1.8043,3.9201,0.5717,3.9072)"
          },
          "CountryRegion": {
            "type": "string",
            "valueString": "USA"
          },
          "CustomerAddress": {
            "type": "string",
            "valueString": "123 Other St, Redmond WA, 98052",
            "spans": [
              "..."
            ],
            "confidence": 0.744,
            "source": "..."
          },
          "CustomerAddressRecipient": {
            "type": "string",
            "valueString": "Microsoft Corp",
            "spans": [
              "..."
            ],
            "confidence": 0.437,
            "source": "..."
          },
          "CustomerId": {
            "type": "string",
            "valueString": "CID-12345",
            "spans": [
              "..."
            ],
            "confidence": 0.936,
            "source": "..."
          },
          "CustomerName": {
            "type": "string",
            "valueString": "MICROSOFT CORPORATION",
            "spans": [
              "..."
            ],
            "confidence": 0.46,
            "source": "..."
          },
          "CustomerTaxId": {
            "type": "string",
            "confidence": 0.912
          },
          "DueDate": {
            "type": "date",
            "valueDate": "2019-12-15",
            "spans": [
              "..."
            ],
            "confidence": 0.97,
            "source": "..."
          },
          "InvoiceDate": {
            "type": "date",
            "valueDate": "2019-11-15",
            "spans": [
              "..."
            ],
            "confidence": 0.939,
            "source": "..."
          },
          "InvoiceId": {
            "type": "string",
            "valueString": "INV-100",
            "spans": [
              "..."
            ],
            "confidence": 0.733,
            "source": "..."
          },
          "LineItems": {
            "type": "array",
            "valueArray": [
              {
                "type": "object",
                "valueObject": {
                  "Date": {
                    "type": "date",
                    "valueDate": "2021-03-04",
                    "spans": [
                      "..."
                    ],
                    "confidence": 0.894,
                    "source": "..."
                  },
                  "Description": {
                    "type": "string",
                    "valueString": "Consulting Services",
                    "spans": [
                      "..."
                    ],
                    "confidence": 0.589,
                    "source": "..."
                  },
                  "ProductCode": {
                    "type": "string",
                    "valueString": "A123",
                    "spans": [
                      "..."
                    ],
                    "confidence": 0.879,
                    "source": "..."
                  },
                  "Quantity": {
                    "type": "number",
                    "valueNumber": 2,
                    "spans": [
                      "..."
                    ],
                    "confidence": 0.939,
                    "source": "..."
                  },
                  "QuantityUnit": {
                    "type": "string",
                    "valueString": "hours",
                    "spans": [
                      "..."
                    ],
                    "confidence": 0.85,
                    "source": "..."
                  },
                  "TaxAmount": {
                    "type": "object",
                    "valueObject": {
                      "Amount": {
                        "type": "number",
                        "valueNumber": 6,
                        "spans": [
                          "..."
                        ],
                        "confidence": 0.522,
                        "source": "..."
                      },
                      "CurrencyCode": {
                        "type": "string",
                        "valueString": "USD"
                      }
                    }
                  },
                  "TaxRate": {
                    "type": "number",
                    "confidence": 0.915
                  },
                  "TotalAmount": {
                    "type": "object",
                    "valueObject": {
                      "Amount": {
                        "type": "number",
                        "valueNumber": 60,
                        "spans": [
                          "..."
                        ],
                        "confidence": 0.972,
                        "source": "..."
                      },
                      "CurrencyCode": {
                        "type": "string",
                        "valueString": "USD"
                      }
                    }
                  },
                  "UnitPrice": {
                    "type": "object",
                    "valueObject": {
                      "Amount": {
                        "type": "number",
                        "valueNumber": 30,
                        "spans": [
                          "..."
                        ],
                        "confidence": 0.97,
                        "source": "..."
                      },
                      "CurrencyCode": {
                        "type": "string",
                        "valueString": "USD"
                      }
                    }
                  }
                }
              },
              "... (2 additional line items)"
            ]
          }
          /*additional fields omitted*/
        },
        "kind": "document",
        "startPageNumber": 1,
        "endPageNumber": 1,
        "unit": "inch",
        "pages": [
          {
            "pageNumber": 1,
            "angle": 0,
            "width": 8.5,
            "height": 11,
            "words": [
              "... (words omitted for brevity)"
            ],
            "selectionMarks": [],
            "lines": [
              "... (lines omitted for brevity)"
            ],
            "barcodes": [],
            "formulas": []
          }
        ],
        "tables": [
          "... (tables omitted for brevity)"
        ],
        "keyValuePairs": [
          "... (key-value pairs omitted for brevity)"
        ],
        "analyzerId": "prebuilt-invoice",
        "mimeType": "application/pdf"
      }
    ]
  },
  "usage": {
    "documentStandardPages": 1,
    "contextualizationTokens": 2345,
    "tokens": {
      "gpt-4.1-mini-input": 1234,
      "gpt-4.1-mini-output": 567
    }
  }
}

Volgende stap

Nu u weet hoe u de analysebewerking kunt aanroepen, leert u meer over het bouwen van aangepaste analyseanalyses voor uw use-case.