Content Understanding API 사용

완료됨

Content Understanding API는 분석기를 만들고, 관리하고, 사용하는 데 사용할 수 있는 프로그래밍 방식 인터페이스를 제공합니다.

API를 사용하기 위해 클라이언트 애플리케이션은 Microsoft Foundry 리소스에 대한 Content Understanding 엔드포인트에 HTTP 호출을 제출하여 헤더의 권한 부여 키 중 하나를 전달합니다. Azure Portal 또는 Microsoft Foundry 포털에서 엔드포인트 및 키를 가져올 수 있습니다. Microsoft Foundry API를 사용하여 Entra ID를 사용하여 프로그래밍 방식으로 프로젝트에 연결할 수도 있습니다.

API를 사용하여 콘텐츠 분석

API의 가장 일반적인 용도 중 하나는 이전에 빌드한 기존 분석기로 콘텐츠를 제출하고 분석 결과를 검색하는 것입니다. 분석 요청은 비동기 작업을 나타내는 작업 ID 값을 반환합니다. 그런 다음 클라이언트 애플리케이션은 다른 요청을 사용하여 작업 ID를 엔드포인트로 다시 전달하고 작업 상태를 검색해야 합니다. 작업이 완료되고 결과가 JSON 형식으로 반환될 때까지 여러 번 폴링될 수 있습니다.

예를 들어 문서를 분석하기 위해 클라이언트 애플리케이션은 다음 JSON 본문을 포함하는 함수에 analyze POST 요청을 제출할 수 있습니다.

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

참고

여기에 표시된 대로 콘텐츠 파일 위치에 대한 URL을 지정할 수 있습니다. 이진 파일 데이터를 직접 제출하려면 대신 작업을 사용합니다 analyzeBinary .

요청이 인증되고 성공적으로 시작되었다고 가정하면 응답은 다음 예제와 유사합니다.

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

그런 다음 클라이언트 애플리케이션은 엔드포인트에 GET 요청을 제출하여 성공(또는 실패)할 때까지 작업 상태를 확인하기 위해 반환된 작업 ID를 analyzerResults 사용해야 합니다.

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

작업이 성공적으로 완료되면 응답에 분석 결과를 나타내는 JSON 페이로드가 포함됩니다. 특정 결과는 콘텐츠 및 스키마에 따라 달라집니다.

참고

Content Understanding API에 대한 자세한 내용은 참조 설명서를 참조하세요.