Hızlı Başlangıç: Çok modüllü içeriği analiz etme (önizleme)

Multimodal API, uygulamaları ve hizmetleri kullanıcı tarafından oluşturulan veya yapay zeka tarafından oluşturulan zararlı içeriklerden daha güvenli hale getirmek için hem görüntü içeriği hem de metin içeriği içeren malzemeleri analiz eder. Bir görüntüyü ve ilişkili metin içeriğini birlikte analiz etmek bağlamı koruyabilir ve içeriğin daha kapsamlı bir şekilde anlaşılmasını sağlayabilir.

İçeriğin filtrelenme şekli hakkında daha fazla bilgi için Bkz . Zarar kategorileri kavramı sayfası. API giriş sınırları için Genel Bakış'ın Giriş gereksinimleri bölümüne bakın.

Önkoşullar

• Azure aboneliği - Ücretsiz bir abonelik oluşturun
• Azure aboneliğinizi aldıktan sonra anahtarınızı ve uç noktanızı almak için Azure portalında bir İçerik Güvenliği kaynağı oluşturun. Kaynağınız için benzersiz bir ad girin, aboneliğinizi seçin ve bir kaynak grubu, desteklenen bölge ve desteklenen fiyatlandırma katmanını seçin. Daha sonra, Oluştur'u seçin.
  • Kaynağın dağıtılması birkaç dakika sürer. Tamamlandıktan sonra Kaynağa git'i seçin. Sol bölmedeki Kaynak Yönetimi'nin altında Abonelik Anahtarı ve Uç Nokta'yı seçin. Uç noktayı ve anahtar değerlerinden birini daha sonra kullanmak üzere geçici bir konuma kopyalayın.
• Aşağıdakilerden biri yüklendi:
  • REST API çağrıları için cURL .
  • Python 3.x yüklü

Resmi metinle analiz etme

Aşağıdaki bölümde, cURL ile örnek bir çok modlu denetim isteğinde yol gösterilir.

Örnek görüntü hazırlama

Analiz etmek için örnek bir görüntü seçin ve cihazınıza indirin.

Görüntü sınırlamaları için bkz . Giriş gereksinimleri . Biçiminiz animasyonluysa, hizmet analizi yapmak için ilk kareyi ayıklar.

Görüntünüzü iki yöntemden biriyle girebilirsiniz: yerel dosya akışı veya blob depolama URL'si.

• Yerel dosya akışı (önerilir): Görüntünüzü base64 olarak kodlayın. Kodlamayı yapmak için codebeautify gibi bir web sitesi kullanabilirsiniz. Ardından kodlanmış dizeyi geçici bir konuma kaydedin.
• Blob depolama URL'si: Görüntünüzü bir Azure Blob Depolama hesabına yükleyin. Bunun nasıl yapılacağını öğrenmek için blob depolama hızlı başlangıcını izleyin. Ardından Azure Depolama Gezgini açın ve görüntünüzün URL'sini alın. Geçici bir konuma kaydedin.

Resmi metinle analiz etme

Aşağıdaki komutu bir metin düzenleyicisine yapıştırın ve aşağıdaki değişiklikleri yapın.

1. değerini kaynak uç noktası URL'nizle değiştirin <endpoint> .
2. <your_subscription_key> yerine anahtarınızı yazın.
3. Gövdedeki "image" alanı bir "content" alan veya "blobUrl" alanla doldurun. Örneğin: {"image": {"content": "<base_64_string>"} veya {"image": {"blobUrl": "<your_storage_url>"}.
4. İsteğe bağlı olarak alanın değerini "text" analiz etmek istediğiniz kendi metninizle değiştirin.

curl --location '<endpoint>/contentsafety/imageWithText:analyze?api-version=2024-09-15-preview ' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data '{
  "image": {
      "content": "<base_64_string>"
 },
  "categories": ["Hate","Sexual","Violence","SelfHarm"],
  "enableOcr": true,
  "text": "I want to kill you"
}'

{
  "image": {
    "blobUrl": "<your_storage_url>"
  }
}

Aşağıdaki alanlar URL'ye eklenmelidir:

İstek gövdesindeki parametreler şu tabloda tanımlanmıştır:

Bir komut istemi penceresi açın ve cURL komutunu çalıştırın.

Çıktı

Görüntü ve metin denetimi sonuçlarının konsolda JSON verileri olarak görüntülendiğini görmeniz gerekir. Örneğin:

{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 2
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 0
    }
  ]
}

Çıktıdaki JSON alanları burada tanımlanır: