Brug Content Understanding API'en

Fuldført

Tip

Se fanen Tekst og billeder for flere detaljer!

Content Understanding API tilbyder et programmatisk interface, som du kan bruge til at oprette, administrere og forbruge analysatorer.

For at bruge API'et sender din klientapplikation HTTP-kald til Content Understanding-endpointet for din Microsoft Foundry-ressource og sender en af autorisationsnøglerne i headeren. Du kan få endpoint og nøgler i Azure-portalen eller i Microsoft Foundry-portalen. Du kan også bruge Microsoft Foundry API'en til at forbinde til projektet programmatisk med dit Entra-ID.

Brug af API'et til at analysere indhold

En af de mest almindelige anvendelser af API'et er at indsende indhold til en eksisterende analysator, som du tidligere har bygget, og hente resultaterne af analysen. Analyseanmodningen returnerer en handlings-id-værdi, der repræsenterer en asynkron opgave. Klientprogrammet skal derefter bruge en anden anmodning til at sende handlings-id'et tilbage til slutpunktet og hente handlingsstatussen – der kan sendes forespørgsler flere gange, indtil handlingen er fuldført, og resultaterne returneres i JSON-format.

Hvis du f.eks. vil analysere et dokument, kan et klientprogram sende en POST-anmodning til den analyze funktion, der indeholder følgende JSON-brødtekst:

POST {endpoint}/contentunderstanding/analyzers/{analyzer}:analyze?api-version=2025-11-01
{
  "inputs": [
    {
      "url": "https://host.com/doc.pdf"
    }
  ]
}

Seddel

Du kan angive en URL til indholdsfilens placering, som vist her. For at indsende binære fildata direkte, brug i stedet operationen analyzeBinary .

Hvis anmodningen godkendes og startes korrekt, svarer svaret til dette eksempel:

Operation-Id: 1234abcd-1234-abcd-1234-abcd1234abcd
Operation-Location: {endpoint}/contentunderstanding/analyzerResults/1234abcd-1234-abcd-1234-abcd1234abcd?api-version=2025-11-01
{
  "id": "1234abcd-1234-abcd-1234-abcd1234abcd",
  "status": "NotStarted"
}

Din klientapplikation skal derefter bruge det operation-ID, der er returneret, til at tjekke operationens status, indtil den er lykkedes (eller fejlede) ved at indsende en GET-anmodning til endepunktet analyzerResults .

GET {endpoint}/contentunderstanding/analyzerResults/1234abcd-1234-abcd-1234-abcd1234abcd?api-version=2025-11-01

Når handlingen er fuldført, indeholder svaret en JSON-nyttedata, der repræsenterer resultaterne af analysen. De specifikke resultater afhænger af indholdet og skemaet.

Seddel

For mere information om Content Understanding API'en, se referencedokumentationen.