Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In dieser Schnellstartanleitung erfahren Sie, wie Sie die REST-API für Inhaltsverständnis verwenden, um strukturierte Daten aus multimodalen Inhalten in Dokument-, Bild-, Audio- und Videodateien abzurufen.
Voraussetzungen
- Um zu beginnen, benötigen Sie ein aktives Azure-Abonnement. Falls Sie kein Azure-Konto haben, können Sie kostenlos eines erstellen.
- Wenn Sie über Ihr Azure-Abonnement verfügen, erstellen Sie eine im Azure-Portal eine Microsoft Foundry-Ressource. Achten Sie darauf, sie in einer unterstützten Region zu erstellen.
- Richten Sie Standardmodellbereitstellungen für Ihre Ressource für Inhaltsverständnis ein. Das Festlegen von Standardwerten erstellt eine Verbindung mit den Foundry-Modellen, die Sie für Inhaltsverständnisanforderungen verwenden. Wählen Sie eine der folgenden Methoden:
- Zur Seite " Einstellungen für inhaltsverständnis" wechseln
- Wählen Sie oben links die Schaltfläche "+ Ressource hinzufügen" aus.
- Wählen Sie die Foundry-Ressource aus, die Sie verwenden möchten, und klicken Sie auf "Weiter", und klicken Sie dann auf "Speichern".
- Stellen Sie sicher, dass Sie "Automatische Bereitstellung für erforderliche Modelle aktivieren, wenn keine Standardwerte verfügbar sind" aktiviert ist. Dadurch wird sichergestellt, dass Ihre Ressource vollständig mit den erforderlichen Modellen GPT-4.1, GPT-4.1-Mini und Text-Embedding-3-Large eingerichtet ist. Für unterschiedliche vorkonfigurierte Analysegeräte sind unterschiedliche Modelle erforderlich.
- In diesem Handbuch verwenden wir das Befehlszeilentool cURL. Wenn sie nicht installiert ist, können Sie die entsprechende Version für Ihre Entwicklungsumgebung herunterladen .
Erste Schritte mit einem vorgefertigten Analyzer
Analysatoren definieren, wie Ihre Inhalte verarbeitet werden, und die Erkenntnisse, die extrahiert werden. Wir bieten vorgefertigte Analysegeräte für gängige Anwendungsfälle an. Sie können vorgefertigte Analysegeräte an Ihre spezifischen Anforderungen und Anwendungsfälle anpassen. Diese Schnellstartanleitung verwendet vorgefertigte Rechnungs-, Bild-, Audio- und Videoanalysatoren, um Ihnen bei den ersten Schritten zu helfen.
Senden einer Datei für die Analyse
Bevor Sie den folgenden cURL-Befehl ausführen, nehmen Sie die folgenden Änderungen an der HTTP-Anforderung vor:
- Ersetzen Sie
{endpoint}und{key}durch die entsprechenden Werte aus Ihrer Foundry-Instanz im Azure-Portal.
POST-Anforderung
In diesem Beispiel wird die prebuilt-invoice Analyse verwendet, um strukturierte Daten aus einem Rechnungsdokument zu extrahieren.
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-Antwort
Der Antwortheader enthält ein Operation-Location Feld, das Sie zum Abrufen der Ergebnisse des asynchronen Analysevorgangs verwenden.
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
Von Bedeutung
Kopieren Sie die Operation-Location-URL aus dem Antwortheader. Sie verwenden diese URL im nächsten Schritt, um die Analyseergebnisse abzurufen.
Abrufen des Analyseergebnisses
Verwenden Sie die Operation-Location von der POST Antwort, und rufen Sie das Ergebnis der Analyse ab.
GET-Anforderung
curl -i -X GET "{endpoint}/contentunderstanding/analyzerResults/{request-id}?api-version=2025-11-01" \
-H "Ocp-Apim-Subscription-Key: {key}"
GET-Antwort
Die JSON-Antwort 200 (OK) enthält ein Feld status, das den Status des Vorgangs angibt. Wenn der Vorgang nicht abgeschlossen ist, lautet der Wert von status entweder Running oder NotStarted. In solchen Fällen sollten Sie die GET Anforderung erneut senden, entweder manuell oder über ein Skript. Warten Sie zwischen den Aufrufen mindestens eine Sekunde.
{
"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
}
}
}
Nächster Schritt
Nachdem Sie nun wissen, wie Sie den Analysevorgang aufrufen, erfahren Sie mehr über das Erstellen von benutzerdefinierten Analysegeräten für Ihren Anwendungsfall.