Folosește API-ul de înțelegere a conținutului

Finalizat

Sfat

Consultați fila Text și imagini pentru mai multe detalii!

API-ul de Înțelegere a Conținutului oferă o interfață programatică pe care o poți folosi pentru a crea, gestiona și consuma analizatoare.

Pentru a folosi API-ul, aplicația clientului tău trimite apeluri HTTP către endpoint-ul Content Understanding pentru resursa Microsoft Foundry, trecând una dintre cheile de autorizare din antet. Poți obține endpoint-ul și cheile în portalul Azure sau în portalul Microsoft Foundry. De asemenea, poți folosi API-ul Microsoft Foundry pentru a te conecta programatic la proiect cu ID-ul tău Entra.

Utilizarea API-ului pentru a analiza conținutul

Una dintre cele mai frecvente utilizări ale API-ului este trimiterea conținutului către un analizor existent pe care l-ai construit anterior și recuperarea rezultatelor analizei. Solicitarea de analiză returnează o valoare ID de operațiune care reprezintă o activitate asincronă. Aplicația client trebuie apoi să utilizeze o altă solicitare pentru a transfera ID-ul operațiunii înapoi la punctul final și a regăsi starea operațiunii - de mai multe ori până când operațiunea este finalizată și rezultatele sunt returnate în format JSON.

De exemplu, pentru a analiza un document, o aplicație client poate trimite o solicitare POST funcției analyze care conține următorul corp JSON:

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

Notă

Poți specifica un URL pentru locația fișierului de conținut, așa cum este prezentat aici. Pentru a trimite direct datele fișierelor binare, folosiți analyzeBinary operația în schimb.

Presupunând că solicitarea este autentificată și inițiată cu succes, răspunsul va fi similar cu acest exemplu:

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

Aplicația ta client trebuie apoi să folosească ID-ul operațiunii returnat pentru a verifica starea operațiunii până când aceasta a reușit (sau eșuat) prin trimiterea unei cereri GET către analyzerResults endpoint.

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

Când operațiunea s-a terminat cu succes, răspunsul conține o sarcină JSON reprezentând rezultatele analizei. Rezultatele specifice depind de conținut și schemă.

Notă

Pentru mai multe informații despre API-ul Content Understanding, consultați documentația de referință.