Görüntü İşleme API'si

Görsel verileri kategorilere ayırmak ve işlemek için görüntülerden zengin bilgileri ayıklayın ve bu Azure Bilişsel Hizmet ile kullanıcılarınızı istenmeyen içeriklerden koruyun.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Standart Tüm Power Automate bölgeleri
Logic Apps Standart Tüm Logic Apps bölgeleri
Power Apps Standart Tüm Power Apps bölgeleri
Power Automate Standart Tüm Power Automate bölgeleri
İletişim
İsim Microsoft
URL Microsoft LogicApps Desteği
Microsoft Power Automate Desteği
Microsoft Power Apps Desteği
Bağlayıcı Meta Verileri
Publisher Microsoft
Web sitesi https://azure.microsoft.com/services/cognitive-services/computer-vision/

Bu tümleştirmeyi kullanmak için Azure portalında bir Bilişsel Hizmet kaynağına ihtiyacınız olacaktır. Uygulamalarınızın kimliğini doğrulamak için bir uç nokta ve anahtar alırsınız. Bağlantı kurmak için Hesap anahtarını, site URL'sini sağlayın ve Bağlantı oluştur'u seçin. Bağlantınızın işlem maliyetleri için burada daha fazla bilgi edinin.

Artık bu tümleştirmeyi kullanmaya başlamaya hazırsınız.

Bilinen sorunlar ve sınırlamalar

Makine öğrenmesi ve desen tanımayı temel alan temel Bilişsel Hizmet Api'si yapısı nedeniyle işlem sonuçlarının eksik olabileceğini lütfen unutmayın.

Microsoft Entra Id ile bağlanma

Microsoft Entra Id ile bağlantı oluşturmak için, erişmek için hesabınıza Bilişsel Hizmetler Kullanıcı rolünü eklemeniz gerekir. Bu bağlantıyı kullanmak için Bilişsel Hizmetler kaynağınızla ilişkili benzersiz alt etki alanını destekleyici işlemlere girmeniz gerekir.

Microsoft Entra ID kimlik doğrulaması ile desteklenmeyen işlemler

Microsoft Entra ID kimlik doğrulaması kullanılırken yalnızca V3 eylemleri desteklenir. Kullanım dışı bırakılan eylemler kimlik doğrulamasıyla Access Key çalışmaya devam eder, ancak Microsoft Entra Id bağlantısıyla kullanıldığında başarısız olur.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Api Anahtarı API Anahtarı Tüm bölgeler Paylaşılabilir
Varsayılan [KULLANIM DIŞI] Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır. Tüm bölgeler Paylaşılamaz

Api Anahtarı

Kimlik Doğrulaması Kimliği: keyBasedAuth

Geçerli: Tüm bölgeler

API Anahtarı

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim Türü Description Gerekli
Hesap Anahtarı securestring Bilişsel Hizmetler Hesap Anahtarı Doğru
Site URL’si String Kök site url'si (Örnek: https://westus.api.cognitive.microsoft.com)

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Hesap Anahtarı securestring Bilişsel Hizmetler Hesap Anahtarı Doğru
Site URL’si String Kök site url'si (Örnek: https://westus.api.cognitive.microsoft.com ). Belirtilmezse site URL'si varsayılan olarak 'https://westus.api.cognitive.microsoft.com' olarak belirlenir.

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 1200 60 saniye

Eylemler

Analyze Image

Bu işlem, görüntü içeriğine göre zengin bir görsel özellik kümesi ayıklar.

Etiket Resmi

Sağlanan görüntünün içeriğiyle ilgili sözcüklerin veya etiketlerin listesini oluşturur.

Etiket Resmi (V3) (Önizleme)

Sağlanan görüntünün içeriğiyle ilgili sözcüklerin veya etiketlerin listesini oluşturur.

Etki Alanına Özgü İçeriği Tanıma

Bir görüntüdeki ünlüleri veya yer işaretlerini tanıma.

Etki Alanına Özgü İçeriği Tanıma (V3) (Önizleme)

Bir görüntüdeki ünlüleri veya yer işaretlerini tanıma.

Görüntü İçeriğini Açıklama

Bu işlem, tam cümleler içeren, okunabilir bir dilde görüntü içeriğinin açıklamasını oluşturur.

Görüntü İçeriğini Açıklama (V3) (Önizleme)

Bu işlem, tam cümleler içeren, okunabilir bir dilde görüntü içeriğinin açıklamasını oluşturur.

Görüntüyü Analiz Etme (V3) (Önizleme)

Bu işlem, görüntü içeriğine göre zengin bir görsel özellik kümesi ayıklar.

İlgi Alanı Al (V3) (Önizleme)

Görüntünün en önemli alanı çevresinde bir sınırlayıcı kutu döndürür.

İlgi Alanını Al

Görüntünün en önemli alanı çevresinde bir sınırlayıcı kutu döndürür.

Küçük Resim Oluştur

Bu işlem, kullanıcı tarafından belirtilen genişlik ve yükseklik ile küçük resim görüntüsü oluşturur.

Küçük Resim Oluştur (V3) (Önizleme)

Bu işlem, kullanıcı tarafından belirtilen genişlik ve yükseklik ile küçük resim görüntüsü oluşturur.

Nesneleri Algıla

Sağlanan görüntüde algılanan nesnelerin listesini oluşturur.

Nesneleri Algılama (V3) (Önizleme)

Sağlanan görüntüde algılanan nesnelerin listesini oluşturur.

Optik Karakter Tanıma (OCR) - JSON (V3) (Önizleme)

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri makine tarafından kullanılabilen bir JSON akışına ayıklar.

Optik Karakter Tanıma (OCR) - Metin

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri bir metin dosyasına ayıklar.

Optik Karakter Tanıma (OCR) -JSON

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri makine tarafından kullanılabilen bir JSON akışına ayıklar.

Optik Karakter Tanıma (OCR) -Metne (V3) (Önizleme)

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri bir metin dosyasına ayıklar.

Resim URL'sini (V3) Açıklama (Önizleme)

Bu işlem, tam cümlelerle insan tarafından okunabilir bir dilde görüntü URL'sinin açıklamasını oluşturur.

Resim URL'sini açıklama

Bu işlem, tam cümlelerle insan tarafından okunabilir bir dilde görüntü URL'sinin açıklamasını oluşturur.

Resmi Açıklama (V3) (Önizleme)

Bu işlem, bir görüntünün tam cümlelerle okunabilir bir dilde açıklamasını oluşturur.

Resmi Tanımlayın

Bu işlem, bir görüntünün tam cümlelerle okunabilir bir dilde açıklamasını oluşturur.

Analyze Image

Bu işlem, görüntü içeriğine göre zengin bir görsel özellik kümesi ayıklar.

Parametreler

Name Anahtar Gerekli Tür Description
Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Etiket Resmi

Sağlanan görüntünün içeriğiyle ilgili sözcüklerin veya etiketlerin listesini oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Etiket Resmi (V3) (Önizleme)

Sağlanan görüntünün içeriğiyle ilgili sözcüklerin veya etiketlerin listesini oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Etki Alanına Özgü İçeriği Tanıma

Bir görüntüdeki ünlüleri veya yer işaretlerini tanıma.

Parametreler

Name Anahtar Gerekli Tür Description
Etki Alanı Modeli
model True string

Görüntüde tanınması için etki alanına özgü model destekleniyor.

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Etki Alanına Özgü İçeriği Tanıma (V3) (Önizleme)

Bir görüntüdeki ünlüleri veya yer işaretlerini tanıma.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Etki Alanı Modeli
model True string

Görüntüde tanınması için etki alanına özgü model destekleniyor.

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Görüntü İçeriğini Açıklama

Bu işlem, tam cümleler içeren, okunabilir bir dilde görüntü içeriğinin açıklamasını oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
En Fazla Aday
maxCandidates number

Döndürülecek en fazla aday açıklaması sayısı.

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Görüntü İçeriği
Image True binary

Gövdedeki görüntü başvurusunun kaynağı.

Döndürülenler

Görüntü İçeriğini Açıklama (V3) (Önizleme)

Bu işlem, tam cümleler içeren, okunabilir bir dilde görüntü içeriğinin açıklamasını oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

En Fazla Aday
maxCandidates number

Döndürülecek en fazla aday açıklaması sayısı.

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Görüntü İçeriği
Image True binary

Gövdedeki görüntü başvurusunun kaynağı.

Döndürülenler

Görüntüyü Analiz Etme (V3) (Önizleme)

Bu işlem, görüntü içeriğine göre zengin bir görsel özellik kümesi ayıklar.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

İlgi Alanı Al (V3) (Önizleme)

Görüntünün en önemli alanı çevresinde bir sınırlayıcı kutu döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

İlgi Alanını Al

Görüntünün en önemli alanı çevresinde bir sınırlayıcı kutu döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Küçük Resim Oluştur

Bu işlem, kullanıcı tarafından belirtilen genişlik ve yükseklik ile küçük resim görüntüsü oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Küçük Resim Genişliği
width True number

Oluşturulan küçük resmin genişliği - önerilen 50

Küçük Resim Yüksekliği
height True number

Oluşturulan küçük resmin yüksekliği - önerilen 50

Akıllı Kırpma
smartCropping boolean

Akıllı kırpmayı etkinleştirmek için Boole bayrağı

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Oluşturulan küçük resim görüntüsü

Küçük resim
binary

Küçük Resim Oluştur (V3) (Önizleme)

Bu işlem, kullanıcı tarafından belirtilen genişlik ve yükseklik ile küçük resim görüntüsü oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Küçük Resim Genişliği
width True number

Oluşturulan küçük resmin genişliği - önerilen 50

Küçük Resim Yüksekliği
height True number

Oluşturulan küçük resmin yüksekliği - önerilen 50

Akıllı Kırpma
smartCropping boolean

Akıllı kırpmayı etkinleştirmek için Boole bayrağı

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Oluşturulan küçük resim görüntüsü

Küçük resim
binary

Nesneleri Algıla

Sağlanan görüntüde algılanan nesnelerin listesini oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Nesneleri Algılama (V3) (Önizleme)

Sağlanan görüntüde algılanan nesnelerin listesini oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Optik Karakter Tanıma (OCR) - JSON (V3) (Önizleme)

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri makine tarafından kullanılabilen bir JSON akışına ayıklar.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

JSON Yanıtı
OCRJsonResponse

Optik Karakter Tanıma (OCR) - Metin

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri bir metin dosyasına ayıklar.

Parametreler

Name Anahtar Gerekli Tür Description
Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Optik Karakter Tanıma (OCR) -JSON

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri makine tarafından kullanılabilen bir JSON akışına ayıklar.

Parametreler

Name Anahtar Gerekli Tür Description
Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

JSON Yanıtı
OCRJsonResponse

Optik Karakter Tanıma (OCR) -Metne (V3) (Önizleme)

Optik Karakter Tanıma (OCR), bir görüntüdeki metni algılar ve tanınan karakterleri bir metin dosyasına ayıklar.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Resim URL'sini (V3) Açıklama (Önizleme)

Bu işlem, tam cümlelerle insan tarafından okunabilir bir dilde görüntü URL'sinin açıklamasını oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

En Fazla Aday
maxCandidates number

Döndürülecek en fazla aday açıklaması sayısı.

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Resim URL'si
url url

URL'ye göre görüntü başvurusu kaynağı.

Döndürülenler

Resim URL'sini açıklama

Bu işlem, tam cümlelerle insan tarafından okunabilir bir dilde görüntü URL'sinin açıklamasını oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
En Fazla Aday
maxCandidates number

Döndürülecek en fazla aday açıklaması sayısı.

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Resim URL'si
url url

URL'ye göre görüntü başvurusu kaynağı.

Döndürülenler

Resmi Açıklama (V3) (Önizleme)

Bu işlem, bir görüntünün tam cümlelerle okunabilir bir dilde açıklamasını oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Alt Etki Alanı veya Bölge
subdomainName True string

Azure alt etki alanı veya coğrafi bölge (ör. westus)

En Fazla Aday
maxCandidates number

Döndürülecek en fazla aday açıklaması sayısı.

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Resmi Tanımlayın

Bu işlem, bir görüntünün tam cümlelerle okunabilir bir dilde açıklamasını oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
En Fazla Aday
maxCandidates number

Döndürülecek en fazla aday açıklaması sayısı.

Language
language string

Hizmet, belirtilen dilde tanıma sonuçlarını döndürür.

Görüntü Kaynağı
format True string

Görüntünün kaynağı - dahil edilen veya başvuru URL'sine göre.

Resim
Image True dynamic

Döndürülenler

Tanımlar

DomainModelResponse

Name Yol Tür Description
Ünlü
result.celebrities array of object

Görüntüde tanınan ünlüler

Ünlü Güveni
result.celebrities.confidence float

Görüntünün ünlü olduğuna dair güvenilirlik puanı

Ünlü Adı
result.celebrities.name string

Tanınan ünlünün adı

Simge
result.landmarks array of object

Görüntüde tanınan yer işaretleri

Yer İşareti Güveni
result.landmarks.confidence float

Görüntünün yer işareti olduğuna dair güvenilirlik puanı

Yer İşareti Adı
result.landmarks.name string

Tanımlanan yer işareti adı

TagResponse

Name Yol Tür Description
tags
tags array of object

Resim analizinden döndürülen etiket kümesi.

Etiket Güvenilirlik Puanı
tags.confidence float

Tanımlanan etiketin güvenilirlik puanı.

Etiket Adı
tags.name string

Tanımlanan etiketin adı.

DetectResponse

Name Yol Tür Description
Nesne
objects array of object

Resim analizinden döndürülen nesne kümesi.

Nesne güvenilirlik puanı
objects.confidence float

Tanımlanan nesnenin güvenilirlik puanı.

Nesne adı
objects.object string

Tanımlanan nesnenin adı.

AreaOfInterestResponse

OCRJsonResponse

Name Yol Tür Description
Metin Dili
language string

Görüntü metninin dili algılandı.

Bölgeler Dizisi
regions array of object

Metin bölgeleri döndürüldü.

OCRTextResponse

Name Yol Tür Description
Algılanan Metin
text string

Analiz edilen görüntüde algılanan metin

AnalyzeResponse

Name Yol Tür Description
categories
categories array of object

Görüntüden tanımlanan kategoriler

Kategori Adı
categories.name string

Görüntüden tanımlanan kategorinin adı

Kategori Güvenilirlik Puanı
categories.score float

Resim kategorisi için Güvenilirlik Puanı

Kapalı açıklamalı altyazılar
description.captions array of object

Görüntüden oluşturulan resim yazılarının listesi

Resim Yazısı Güvenilirlik Puanı
description.captions.confidence float

Resim yazısının güvenilirlik puanı

Resim Yazısı Metni
description.captions.text string

Görüntüden oluşturulan metin yazısı

Etiket Adları
description.tags array of string

Etiket adları koleksiyonu.

tags
tags array of object

Güvenilirlik puanlarıyla tanımlanan etiketler.

Etiket Güvenilirlik Puanı
tags.confidence float

Tanımlanan etiketler için güvenilirlik puanı.

Etiket Adı
tags.name string

Tanımlanan etiketin adı.

DescribeResponse

Name Yol Tür Description
Kapalı açıklamalı altyazılar
description.captions array of object

Görüntüden oluşturulan resim yazılarının listesi

Resim Yazısı Güvenilirlik Puanı
description.captions.confidence float

Resim yazısının güvenilirlik puanı

Resim Yazısı Metni
description.captions.text string

Görüntüden oluşturulan metin yazısı

Etiket Adları
description.tags array of string

Etiket adları koleksiyonu.

ikili

Bu, 'ikili' temel veri türüdür.