Delen via

Computer Vision-API

Extraheer uitgebreide informatie uit afbeeldingen om visuele gegevens te categoriseren en te verwerken, en bescherm uw gebruikers tegen ongewenste inhoud met deze Azure Cognitive Service.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Standaard Alle Power Automate regio's
Logic-apps Standaard Alle Logic Apps-regio's
Power Apps Standaard Alle Power Apps regio's
Power Automate Standaard Alle Power Automate regio's
Contactpersoon
Naam Microsoft
URL Ondersteuning voor Microsoft LogicApps
Ondersteuning voor Microsoft Power Automate
Ondersteuning voor Microsoft Power Apps
Connectormetagegevens
Uitgever Microsoft
Webpagina https://azure.microsoft.com/services/cognitive-services/computer-vision/

Als u deze integratie wilt gebruiken, hebt u een Cognitive Service-resource nodig in Azure Portal. U krijgt een eindpunt en een sleutel voor het verifiëren van uw toepassingen. Als u een verbinding wilt maken, geeft u de accountsleutel, site-URL op en selecteert u Verbinding maken. Meer informatie hier vindt u voor de operationele kosten voor uw verbinding.

U kunt deze integratie nu gaan gebruiken.

Bekende problemen en beperkingen

Houd er rekening mee dat de resultaten van bewerkingen mogelijk onvolledig zijn vanwege de onderliggende aard van de Cognitive Service-API , die is gebaseerd op machine learning en patroonherkenning.

Verbinding maken met Microsoft Entra-id

Als u verbindingen met Microsoft Entra-id wilt maken, moet u de rol Cognitive Services-gebruiker toevoegen aan uw account om toegang te krijgen. Als u deze verbinding wilt gebruiken, moet u het unieke subdomein invoeren dat is gekoppeld aan uw Cognitive Services-resource in de ondersteunende bewerkingen.

Bewerkingen worden niet ondersteund met Microsoft Entra ID-verificatie

Wanneer u Microsoft Entra ID-verificatie gebruikt, worden alleen V3-acties ondersteund. Afgeschafte acties blijven werken met Access Key verificatie, maar mislukken als ze worden gebruikt met een Microsoft Entra ID-verbinding.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
Api-sleutel API-sleutel Alle regio's Deelbaar
Standaard [AFGESCHAFT] Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. Alle regio's Niet deelbaar

Api-sleutel

Verificatie-id: keyBasedAuth

Van toepassing: Alle regio's

API-sleutel

Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs

Naam Typologie Description Verplicht
Accountsleutel beveiligde string Cognitive Services-accountsleutel Klopt
Site-URL touw URL van hoofdsite (voorbeeld: https://westus.api.cognitive.microsoft.com)

Standaard [AFGESCHAFT]

Van toepassing: Alle regio's

Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
Accountsleutel beveiligde string Cognitive Services-accountsleutel Klopt
Site-URL touw Url van hoofdsite (voorbeeld: https://westus.api.cognitive.microsoft.com ). Als de url van de site niet is opgegeven, wordt standaard ingesteld op 'https://westus.api.cognitive.microsoft.com'.

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 1200 60 seconden

Acties

Afbeelding analyseren (V3) (preview)

Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding.
Afbeelding beschrijven

Met deze bewerking wordt een beschrijving gegenereerd van een afbeelding in een leesbare taal met volledige zinnen.
Afbeelding beschrijven (V3) (preview)

Met deze bewerking wordt een beschrijving gegenereerd van een afbeelding in een leesbare taal met volledige zinnen.
Afbeeldings-URL (V3) beschrijven (preview)

Met deze bewerking wordt een beschrijving gegenereerd van een afbeeldings-URL in een leesbare taal met volledige zinnen.
Afbeeldings-URL beschrijven

Met deze bewerking wordt een beschrijving gegenereerd van een afbeeldings-URL in een leesbare taal met volledige zinnen.
Afbeeldingsinhoud beschrijven

Met deze bewerking wordt een beschrijving gegenereerd van afbeeldingsinhoud in een leesbare taal met volledige zinnen.
Afbeeldingsinhoud beschrijven (V3) (preview)

Met deze bewerking wordt een beschrijving gegenereerd van afbeeldingsinhoud in een leesbare taal met volledige zinnen.
Analyze Image

Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding.
Domeinspecifieke inhoud herkennen

Beroemdheden of oriëntatiepunten in een afbeelding herkennen.
Domeinspecifieke inhoud herkennen (V3) (preview)

Beroemdheden of oriëntatiepunten in een afbeelding herkennen.
Interessegebied ophalen

Retourneert een begrenzingsvak rond het belangrijkste gebied van de afbeelding.
Interessegebied ophalen (V3) (preview)

Retourneert een begrenzingsvak rond het belangrijkste gebied van de afbeelding.
Miniatuur genereren

Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte.
Miniatuur genereren (V3) (preview)

Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte.
Objecten detecteren

Hiermee wordt een lijst gegenereerd met gedetecteerde objecten in de opgegeven afbeelding.
Objecten detecteren (V3) (preview)

Hiermee wordt een lijst gegenereerd met gedetecteerde objecten in de opgegeven afbeelding.
Optische tekenherkenning (OCR) naar JSON

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een machine bruikbare JSON-stroom.
Optische tekenherkenning (OCR) naar JSON (V3) (preview)

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een machine bruikbare JSON-stroom.
Optische tekenherkenning (OCR) naar tekst

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een tekstbestand.
Optische tekenherkenning (OCR) naar tekst (V3) (preview)

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een tekstbestand.
Tag afbeelding

Hiermee wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding.
Tagafbeelding (V3) (preview)

Hiermee wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding.

Afbeelding analyseren (V3) (preview)

Bewerkings-id:
AnalyzeImageV3

Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
AnalyzeResponse

Afbeelding beschrijven

Bewerkings-id:
DescribeImageV2

Met deze bewerking wordt een beschrijving gegenereerd van een afbeelding in een leesbare taal met volledige zinnen.

Parameters

Name Sleutel Vereist Type Description
Maximum aantal kandidaten
 maxCandidates number

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd.
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
DescribeResponse

Afbeelding beschrijven (V3) (preview)

Bewerkings-id:
DescribeImageV3

Met deze bewerking wordt een beschrijving gegenereerd van een afbeelding in een leesbare taal met volledige zinnen.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Maximum aantal kandidaten
 maxCandidates number

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd.
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
DescribeResponse

Afbeeldings-URL (V3) beschrijven (preview)

Bewerkings-id:
DescribeImageURLV3

Met deze bewerking wordt een beschrijving gegenereerd van een afbeeldings-URL in een leesbare taal met volledige zinnen.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Maximum aantal kandidaten
 maxCandidates number

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd.
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldings-URL
 url url

Bron van afbeeldingsreferentie per URL.

Retouren

Body
DescribeResponse

Afbeeldings-URL beschrijven

Bewerkings-id:
DescribeImageURLV2

Met deze bewerking wordt een beschrijving gegenereerd van een afbeeldings-URL in een leesbare taal met volledige zinnen.

Parameters

Name Sleutel Vereist Type Description
Maximum aantal kandidaten
 maxCandidates number

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd.
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldings-URL
 url url

Bron van afbeeldingsreferentie per URL.

Retouren

Body
DescribeResponse

Afbeeldingsinhoud beschrijven

Bewerkings-id:
DescribeImageContentV2

Met deze bewerking wordt een beschrijving gegenereerd van afbeeldingsinhoud in een leesbare taal met volledige zinnen.

Parameters

Name Sleutel Vereist Type Description
Maximum aantal kandidaten
 maxCandidates number

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd.
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldingsinhoud
 Image True binary

Bron van de afbeeldingsreferentie in hoofdtekst.

Retouren

Body
DescribeResponse

Afbeeldingsinhoud beschrijven (V3) (preview)

Bewerkings-id:
DescribeImageContentV3

Met deze bewerking wordt een beschrijving gegenereerd van afbeeldingsinhoud in een leesbare taal met volledige zinnen.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Maximum aantal kandidaten
 maxCandidates number

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd.
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldingsinhoud
 Image True binary

Bron van de afbeeldingsreferentie in hoofdtekst.

Retouren

Body
DescribeResponse

Analyze Image

Bewerkings-id:
AnalyzeImageV2

Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding.

Parameters

Name Sleutel Vereist Type Description
Language
 language string

De service retourneert herkenningsresultaten in de opgegeven taal.
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
AnalyzeResponse

Domeinspecifieke inhoud herkennen

Bewerkings-id:
RecognizeDomainSpecificContentV2

Beroemdheden of oriëntatiepunten in een afbeelding herkennen.

Parameters

Name Sleutel Vereist Type Description
Domeinmodel
 model True string

Ondersteund domeinspecifiek model om in afbeelding te herkennen.
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
DomainModelResponse

Domeinspecifieke inhoud herkennen (V3) (preview)

Bewerkings-id:
RecognizeDomainSpecificContentV3

Beroemdheden of oriëntatiepunten in een afbeelding herkennen.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Domeinmodel
 model True string

Ondersteund domeinspecifiek model om in afbeelding te herkennen.
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
DomainModelResponse

Interessegebied ophalen

Bewerkings-id:
GetAreaOfInterest

Retourneert een begrenzingsvak rond het belangrijkste gebied van de afbeelding.

Parameters

Name Sleutel Vereist Type Description
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
AreaOfInterestResponse

Interessegebied ophalen (V3) (preview)

Bewerkings-id:
GetAreaOfInterestV3

Retourneert een begrenzingsvak rond het belangrijkste gebied van de afbeelding.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
AreaOfInterestResponse

Miniatuur genereren

Bewerkings-id:
GetThumbnailV2

Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte.

Parameters

Name Sleutel Vereist Type Description
Miniatuurbreedte
 width True number

Breedte van de gegenereerde miniatuur - aanbevolen is 50
Miniatuurhoogte
 height True number

Hoogte van de gegenereerde miniatuur - aanbevolen is 50
Slim bijsnijden
 smartCropping boolean

Booleaanse vlag voor het inschakelen van slim bijsnijden
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Gegenereerde miniatuurafbeelding

Miniatuurafbeelding
binary

Miniatuur genereren (V3) (preview)

Bewerkings-id:
GetThumbnailV3

Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Miniatuurbreedte
 width True number

Breedte van de gegenereerde miniatuur - aanbevolen is 50
Miniatuurhoogte
 height True number

Hoogte van de gegenereerde miniatuur - aanbevolen is 50
Slim bijsnijden
 smartCropping boolean

Booleaanse vlag voor het inschakelen van slim bijsnijden
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Gegenereerde miniatuurafbeelding

Miniatuurafbeelding
binary

Objecten detecteren

Bewerkings-id:
DetectObjects

Hiermee wordt een lijst gegenereerd met gedetecteerde objecten in de opgegeven afbeelding.

Parameters

Name Sleutel Vereist Type Description
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
DetectResponse

Objecten detecteren (V3) (preview)

Bewerkings-id:
DetectObjectsV3

Hiermee wordt een lijst gegenereerd met gedetecteerde objecten in de opgegeven afbeelding.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
DetectResponse

Optische tekenherkenning (OCR) naar JSON

Bewerkings-id:
OCRV2

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een machine bruikbare JSON-stroom.

Parameters

Name Sleutel Vereist Type Description
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

JSON-antwoord
OCRJsonResponse

Optische tekenherkenning (OCR) naar JSON (V3) (preview)

Bewerkings-id:
OCRV3

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een machine bruikbare JSON-stroom.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

JSON-antwoord
OCRJsonResponse

Optische tekenherkenning (OCR) naar tekst

Bewerkings-id:
OCRTextV2

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een tekstbestand.

Parameters

Name Sleutel Vereist Type Description
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
OCRTextResponse

Optische tekenherkenning (OCR) naar tekst (V3) (preview)

Bewerkings-id:
OCRTextV3

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een tekstbestand.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
OCRTextResponse

Tag afbeelding

Bewerkings-id:
TagImageV2

Hiermee wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding.

Parameters

Name Sleutel Vereist Type Description
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
TagResponse

Tagafbeelding (V3) (preview)

Bewerkings-id:
TagImageV3

Hiermee wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding.

Parameters

Name Sleutel Vereist Type Description
Resourcesubdomein of -regio
 subdomainName True string

Azure-subdomein of geografische regio (bijvoorbeeld westus)
Afbeeldingsbron
 format True string

Bron van de afbeelding: opgenomen of door referentie-URL.
Afbeelding
 Image True dynamic

Retouren

Body
TagResponse

Definities

DomainModelResponse

Name Pad Type Description
Beroemdheden
 result.celebrities array of object

Herkende beroemdheden in afbeelding
Betrouwbaarheid van beroemdheden
 result.celebrities.confidence float

Betrouwbaarheidsscore die afbeelding van beroemdheid is
Naam van beroemdheden
 result.celebrities.name string

Naam van de herkende beroemdheid
Bezienswaardigheden
 result.landmarks array of object

Herkende oriëntatiepunten in afbeelding
Betrouwbaarheid van oriëntatiepunten
 result.landmarks.confidence float

Betrouwbaarheidsscore die afbeelding van oriëntatiepunt is
Naam van oriëntatiepunt
 result.landmarks.name string

Naam van het geïdentificeerde oriëntatiepunt

TagResponse

Name Pad Type Description
tags
 tags array of object

Set tags die worden geretourneerd door de afbeeldingsanalyse.
Betrouwbaarheidsscore taggen
 tags.confidence float

Betrouwbaarheidsscore van de geïdentificeerde tag.
Tag Naam
 tags.name string

Naam van de geïdentificeerde tag.

DetectResponse

Name Pad Type Description
Objecten
 objects array of object

Set objecten die worden geretourneerd uit de afbeeldingsanalyse.
Betrouwbaarheidsscore van objecten
 objects.confidence float

Betrouwbaarheidsscore van het geïdentificeerde object.
Objectnaam
 objects.object string

De naam van het geïdentificeerde object.

AreaOfInterestResponse

OCRJsonResponse

Name Pad Type Description
Teksttaal
 language string

De taal van de afbeeldingstekst is gedetecteerd.
Matrix regio's
 regions array of object

Tekstregio's geretourneerd.

OCRTextResponse

Name Pad Type Description
Gedetecteerde tekst
 text string

Tekst gedetecteerd in de geanalyseerde afbeelding

AnalyzeResponse

Name Pad Type Description
categories
 categories array of object

Categorieën die zijn geïdentificeerd op basis van de afbeelding
Categorienaam
 categories.name string

Naam van de categorie die is geïdentificeerd op basis van de afbeelding
Betrouwbaarheidsscore van categorie
 categories.score float

Betrouwbaarheidsscore voor de afbeeldingscategorie
Bijschriften
 description.captions array of object

Lijst met bijschriften die zijn gegenereerd op basis van de afbeelding
Betrouwbaarheidsscore bijschrift
 description.captions.confidence float

Betrouwbaarheidsscore van het bijschrift van de afbeelding
Bijschrifttekst
 description.captions.text string

Tekstbijschrift gegenereerd op basis van de afbeelding
Tagnamen
 description.tags array of string

Verzameling tagnamen.
tags
 tags array of object

Tags geïdentificeerd met betrouwbaarheidsscores.
Betrouwbaarheidsscore taggen
 tags.confidence float

Betrouwbaarheidsscore voor de geïdentificeerde tags.
Tag Naam
 tags.name string

Naam van de geïdentificeerde tag.

DescribeResponse

Name Pad Type Description
Bijschriften
 description.captions array of object

Lijst met bijschriften die zijn gegenereerd op basis van de afbeelding
Betrouwbaarheidsscore bijschrift
 description.captions.confidence float

Betrouwbaarheidsscore van het bijschrift van de afbeelding
Bijschrifttekst
 description.captions.text string

Tekstbijschrift gegenereerd op basis van de afbeelding
Tagnamen
 description.tags array of string

Verzameling tagnamen.

binair

Dit is het basisgegevenstype 'binair'.