Aracılığıyla paylaş

Resimlerdeki arka planı kaldırma

  • Makale

Önemli

Bu özellik artık kullanım dışıdır. 10 Ocak 2025'te Azure AI Görüntü Analizi 4.0 Segment API'si ve arka planı kaldırma hizmeti kullanımdan kaldırılacaktır. Bu hizmete yönelik tüm istekler bu tarihten sonra başarısız olur.

Modellerinizin sorunsuz çalışmasını sağlamak için açık kaynak Florence 2 modelini yükleyin ve benzer bir arka plan kaldırma işlemine olanak tanıyan Region to segmentation özelliğini kullanın.

Bu makalede, bir görüntüyü segmentlere ayırmak için Görüntü Analizi 4.0 API'sini çağırma (ön planı arka plandan ayırma) gösterilmektedir. Ayrıca döndürülen bilgilerin nasıl ayrıştırabileceğinizi de gösterir.

Önemli

Arka planı kaldırma yalnızca doğrudan REST API çağrıları aracılığıyla kullanılabilir. SDK'lar aracılığıyla kullanılamaz.

Önkoşullar

Bu kılavuzda, hızlı başlangıç sayfasında belirtilen adımları başarıyla izlediğiniz varsayılır . Diğer bir deyişle:

  • Bir Görüntü İşleme kaynağı oluşturdunuz ve bir anahtar ve uç nokta URL'si edindiniz.
  • Hizmete başarıyla bir curl.exe çağrı yaptınız (veya alternatif bir araç kullandınız). Çağrıyı curl.exe buradaki örneklere göre değiştirirsiniz.

Hızlı başlangıçta bir görüntüden görsel özelliklerin nasıl ayıklanması gösterilmektedir. Ancak, kavramlar arka plan kaldırmaya benzer. Bu nedenle, hızlı başlangıç ile başlayıp değişiklikler yapmaktan yararlanabilirsiniz.

Önemli

Arka planı kaldırma yalnızca belirli Azure bölgelerinde kullanılabilir. Bkz. Bölge kullanılabilirliği

Hizmette kimlik doğrulaması

Görüntü Analizi hizmetinde kimlik doğrulaması yapmak için bir Görüntü İşleme anahtarı ve uç nokta URL'si gerekir.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Kimlik doğrulaması, HTTP istek üst bilgisi Ocp-Apim-Subscription-Key eklenerek ve görüntü işleme anahtarınıza ayarlanarak yapılır. Çağrı URL'sine <endpoint>/computervision/imageanalysis:segment?api-version=2023-02-01-previewyapılır; burada <endpoint> benzersiz Görüntü İşleme uç nokta URL'nizdir. Bu URL'ye eklediğiniz başka bir sorgu dizesi için mod seçme bölümüne bakın.

Analiz etmek için görüntüyü seçin

Bu kılavuzdaki kod, URL tarafından başvuruda bulunan uzak görüntüleri kullanır. Görüntü Analizi özelliklerinin tüm özelliklerini görmek için farklı görüntüleri kendiniz denemek isteyebilirsiniz.

Uzak görüntüyü analiz ederken, istek gövdesini şu şekilde biçimlendirerek görüntünün URL'sini belirtirsiniz: {"url":"https://learn.microsoft.com/azure/ai-services/computer-vision/images/windows-kitchen.jpg"}. İçerik Türü olmalıdırapplication/json.

Yerel görüntüyü analiz etmek için ikili görüntü verilerini HTTP isteği gövdesine koyarsınız. İçerik Türü veya multipart/form-dataolmalıdırapplication/octet-stream.

Mod seçme

Sorgu dizesi modunu bu iki değerden birine ayarlayın. Görüntü segmentasyonu yapmak istiyorsanız bu sorgu dizesi zorunludur.

URL parametresi Value Açıklama
mode backgroundRemoval Algılanan ön plan nesnesinin saydam arka planlı bir görüntüsünün çıktısını alır.
mode foregroundMatting Algılanan ön plan nesnesinin opaklığını gösteren gri ölçekli alfa mat bir görüntü oluşturur.

backgroundRemoval için doldurulmuş bir URL şöyle görünür: <endpoint>/computervision/imageanalysis:segment?api-version=2023-02-01-preview&mode=backgroundRemoval

Hizmetten sonuç alma

Bu bölümde, API çağrısı yapmayı ve sonuçları ayrıştırma işlemini gösterir.

Hizmet, ile Content-Type: image/pngbaşarılı olduğunda bir 200 HTTP yanıtı döndürür ve gövde, döndürülen PNG görüntüsünü ikili akış biçiminde içerir.

Örneğin, arka planı kaldırma işleminin aşağıdaki görüntüde çalıştırıldığından varsayın:

Suya yakın bir şehrin fotoğrafı.

Başarılı bir arka plan kaldırma çağrısında, modun yanıtı backgroundRemoval aşağıdaki dört kanallı PNG görüntüsüdür:

Suya yakın bir şehrin fotoğrafı; gökyüzü saydamdır.

Aşağıdaki tek kanallı PNG görüntüsü, modun foregroundMatting yanıtıdır:

Bir şehir silüetinin alfa matı.

API, modun özgün boyutuyla aynı boyutta ancak mod için foregroundMatting backgroundRemoval en fazla 16 megapiksel (görüntü en boy oranını koruyarak) bir görüntü döndürür.

Hata kodları

Hata oluştuğunda, Görüntü Analizi hizmeti yanıtı bir hata kodu ve hata iletisi içeren bir JSON yükü içerir. Ayrıca, ve iç hata kodu ve iletisi biçimindeki diğer ayrıntıları da içerebilir. Örneğin:

{
    "error":
    {
        "code": "InvalidRequest",
        "message": "Analyze query is invalid.",
        "innererror":
        {
            "code": "NotSupportedVisualFeature",
            "message": "Specified feature type is not valid"
        }
    }
}

Yaygın hataların ve bunların nedenlerinin listesi aşağıdadır. Liste öğeleri aşağıdaki biçimde sunulur:

  • HTTP yanıt kodu
    • JSON yanıtında hata kodu ve ileti
      • [İsteğe bağlı] JSON yanıtında iç hata kodu ve ileti

Sık karşılaşılan hataların listesi:

  • 400 Bad Request
    • InvalidRequest - Image URL is badly formatted or not accessible. Resim URL'sinin geçerli ve genel olarak erişilebilir olduğundan emin olun.
    • InvalidRequest - The image size is not allowed to be zero or larger than 20971520 bytes. Resmi sıkıştırarak ve/veya yeniden boyutlandırarak resmin boyutunu küçültün ve isteğinizi yeniden gönderin.
    • InvalidRequest - The feature 'Caption' is not supported in this region. Özellik yalnızca belirli Azure bölgelerinde desteklenir. Desteklenen Azure bölgeleri listesi için hızlı başlangıç önkoşulları bölümüne bakın.
    • InvalidRequest - The provided image content type ... is not supported. İstekteki HTTP üst bilgisi content-Type izin verilen bir tür değildir:
      • Resim URL'si için İçerik Türüapplication/json
      • İkili görüntü verileri için İçerik Türü veya olmalıdır application/octet-streammultipart/form-data
    • InvalidRequest - Either 'features' or 'model-name' needs to be specified in the query parameter.
    • InvalidRequest - Image format is not valid
    • InvalidRequest - Analyze query is invalid
      • NotSupportedVisualFeature - Specified feature type is not valid. Özellikler sorgu dizesinin geçerli bir değere sahip olduğundan emin olun.
      • NotSupportedLanguage - The input language is not supported. Dil sorgu dizesinin, aşağıdaki tabloya göre seçili görsel özelliği için geçerli bir değere sahip olduğundan emin olun.
      • BadArgument - 'smartcrops-aspect-ratios' aspect ratio is not in allowed range [0.75 to 1.8]
  • 401 PermissionDenied
    • 401 - Access denied due to invalid subscription key or wrong API endpoint. Make sure to provide a valid key for an active subscription and use a correct regional API endpoint for your resource.
  • 404 Resource Not Found
    • 404 - Resource not found. Hizmet, sorgu dizesi tarafından model-name sağlanan ada göre özel modeli bulamadı.

İpucu

Azure AI Vision ile çalışırken hizmet tarafından uygulanan hız sınırlarının neden olduğu geçici hatalarla veya ağ kesintileri gibi diğer geçici sorunlarla karşılaşabilirsiniz. Bu tür hataları işleme hakkında daha fazla bilgi için Bulut Tasarım Desenleri kılavuzundaki Yeniden deneme deseni kılavuzuna ve ilgili Devre Kesici düzenine bakın.

Sonraki adımlar

Arka planı kaldırma kavramları