Content Understanding API'sini kullanma

Tamamlandı

Tip

Daha fazla ayrıntı için Metin ve resimler sekmesine bakın!

Content Understanding API'sinde çözümleyicileri oluşturmak, yönetmek ve kullanmak için kullanabileceğiniz bir program arabirimi sağlanır.

API'yi kullanmak için istemci uygulamanız Microsoft Foundry kaynağınızın Content Understanding uç noktasına HTTP çağrıları gönderir ve üst bilgideki yetkilendirme anahtarlarından birini geçirir. Uç noktayı ve anahtarları Azure portalından veya Microsoft Foundry portalından alabilirsiniz. Ayrıca, Entra Id ile programatik olarak projeye bağlanmak için Microsoft Foundry API'sini de kullanabilirsiniz.

İçeriği analiz etmek için API'yi kullanma

API'nin en yaygın kullanımlarından biri, daha önce oluşturduğunuz mevcut bir çözümleyiciye içerik göndermek ve çözümleme sonuçlarını almaktır. Çözümleme isteği, zaman uyumsuz bir görevi temsil eden bir işlem kimliği değeri döndürür. İstemci uygulamanızın daha sonra işlem kimliğini uç noktaya geri iletmek ve işlem durumunu almak için başka bir istek kullanması gerekir. İşlem tamamlanana ve sonuçlar JSON biçiminde döndürülene kadar birden çok kez yoklama yapılabilir.

Örneğin, bir belgeyi analiz etmek için istemci uygulaması aşağıdaki JSON gövdesini analyze içeren işleve bir POST isteği gönderebilir:

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

Not

İçerik dosyası konumu için burada gösterildiği gibi bir URL belirtebilirsiniz. İkili dosya verilerini doğrudan göndermek için bunun yerine işlemini kullanın analyzeBinary .

İsteğin kimliğinin doğrulanıp başarıyla başlatıldığı varsayıldığında, yanıt şu örneğe benzer olacaktır:

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

İstemci uygulamanızın daha sonra, uç noktaya bir GET isteği göndererek başarılı (veya başarısız) olana kadar işlemin durumunu denetlemek için analyzerResults döndürülen işlem kimliğini kullanması gerekir.

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

İşlem başarıyla tamamlandığında, yanıt analizin sonuçlarını temsil eden bir JSON yükü içerir. Belirli sonuçlar içeriğe ve şemaya bağlıdır.

Not

Content Understanding API'si hakkında daha fazla bilgi için başvuru belgelerine bakın.