ComputerVisionClient Klas

De Computer Vision-API biedt state-of-the-art algoritmen voor het verwerken van afbeeldingen en het retourneren van informatie. Het kan bijvoorbeeld worden gebruikt om te bepalen of een afbeelding inhoud voor volwassenen bevat, of kan worden gebruikt om alle gezichten in een afbeelding te vinden. De API heeft ook nog andere functies, zoals het schatten van dominante kleuren en accentkleuren,het categoriseren van de inhoud van afbeeldingen en het beschrijven van een afbeelding met volledige Engelse zinnen. Bovendien kan de API op intelligente wijze miniaturen van afbeeldingen genereren voor het effectief weergeven van grote afbeeldingen.

Overname

azure.cognitiveservices.vision.computervision.operations._computer_vision_client_operations.ComputerVisionClientOperationsMixin

ComputerVisionClient

SDKClient

ComputerVisionClient

Constructor

ComputerVisionClient(endpoint, credentials)

Parameters

endpoint

str

Vereist

Ondersteunde Cognitive Services-eindpunten.

credentials

None

Vereist

Abonnementsreferenties waarmee het clientabonnement uniek wordt geïdentificeerd.

Variabelen

config

ComputerVisionClientConfiguration

Configuratie voor client.

Methoden

analyze_image	Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. In uw aanvraag is er een optionele parameter waarmee u kunt kiezen welke functies u wilt retourneren. Standaard worden afbeeldingscategorieën geretourneerd in het antwoord. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
analyze_image_by_domain	Met deze bewerking wordt inhoud in een afbeelding herkend door een domeinspecifiek model toe te passen. De lijst met domeinspecifieke modellen die worden ondersteund door de Computer Vision API kan worden opgehaald met behulp van de GET-aanvraag /models. Momenteel biedt de API de volgende domeinspecifieke modellen: beroemdheden, oriëntatiepunten. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
analyze_image_by_domain_in_stream	Met deze bewerking wordt inhoud in een afbeelding herkend door een domeinspecifiek model toe te passen. De lijst met domeinspecifieke modellen die worden ondersteund door de Computer Vision API kan worden opgehaald met behulp van de GET-aanvraag /models. Momenteel biedt de API de volgende domeinspecifieke modellen: beroemdheden, oriëntatiepunten. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
analyze_image_in_stream	Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. In uw aanvraag is er een optionele parameter waarmee u kunt kiezen welke functies u wilt retourneren. Standaard worden afbeeldingscategorieën geretourneerd in het antwoord. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
close	Sluit de client als keep_alive Waar is.
describe_image	Deze bewerking genereert een beschrijving van een afbeelding in door mensen leesbare taal met volledige zinnen. De beschrijving is gebaseerd op een verzameling inhoudstags, die ook worden geretourneerd door de bewerking. Er kan meer dan één beschrijving worden gegenereerd voor elke afbeelding. Beschrijvingen worden geordend op hun betrouwbaarheidsscore. Beschrijvingen kunnen resultaten bevatten van beroemdheids- en oriëntatiepuntdomeinmodellen, indien van toepassing. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
describe_image_in_stream	Deze bewerking genereert een beschrijving van een afbeelding in door mensen leesbare taal met volledige zinnen. De beschrijving is gebaseerd op een verzameling inhoudstags, die ook worden geretourneerd door de bewerking. Er kan meer dan één beschrijving worden gegenereerd voor elke afbeelding. Beschrijvingen worden geordend op hun betrouwbaarheidsscore. Beschrijvingen kunnen resultaten bevatten van beroemdheids- en oriëntatiepuntdomeinmodellen, indien van toepassing. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
detect_objects	Hiermee wordt objectdetectie uitgevoerd op de opgegeven afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
detect_objects_in_stream	Hiermee wordt objectdetectie uitgevoerd op de opgegeven afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
generate_thumbnail	Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte. Standaard wordt met de service de afbeelding geanalyseerd, het interessegebied bepaald en op basis van het interessegebied coördinaten voor slim bijsnijden gegenereerd. Slim bijsnijden helpt wanneer u een hoogte-breedteverhouding opgeeft die afwijkt van die van de invoerafbeelding. Een geslaagd antwoord bevat het binaire bestand voor de miniatuurafbeelding. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan een van de volgende zijn: InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError.
generate_thumbnail_in_stream	Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte. Standaard wordt met de service de afbeelding geanalyseerd, het interessegebied bepaald en op basis van het interessegebied coördinaten voor slim bijsnijden gegenereerd. Slim bijsnijden helpt wanneer u een hoogte-breedteverhouding opgeeft die afwijkt van die van de invoerafbeelding. Een geslaagd antwoord bevat het binaire bestand voor de miniatuurafbeelding. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan een van de volgende zijn: InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError.
get_area_of_interest	Met deze bewerking wordt een begrenzingsvak rond het belangrijkste gebied van de afbeelding geretourneerd. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError zijn.
get_area_of_interest_in_stream	Met deze bewerking wordt een begrenzingsvak rond het belangrijkste gebied van de afbeelding geretourneerd. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError zijn.
get_read_result	Deze interface wordt gebruikt voor het ophalen van OCR-resultaten van de leesbewerking. De URL naar deze interface moet worden opgehaald uit het veld 'Operation-Location' dat wordt geretourneerd uit de leesinterface.
list_models	Deze bewerking retourneert de lijst met domeinspecifieke modellen die worden ondersteund door de Computer Vision-API. Momenteel ondersteunt de API de volgende domeinspecifieke modellen: celebrity recognizer, landmark recognizer. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
read	Gebruik deze interface om het resultaat van een leesbewerking te verkrijgen, waarbij gebruik wordt gemaakt van de state-of-the-art OCR-algoritmen (Optical Character Recognition) die zijn geoptimaliseerd voor tekstintensieve documenten. Wanneer u de leesinterface gebruikt, bevat het antwoord een veld met de naam Operation-Location. Het veld Operation-Location bevat de URL die u moet gebruiken voor de bewerking GetReadResult om toegang te krijgen tot OCR-resultaten..
read_in_stream	Gebruik deze interface om het resultaat van een leesbewerking te verkrijgen, waarbij gebruik wordt gemaakt van de state-of-the-art OCR-algoritmen (Optical Character Recognition) die zijn geoptimaliseerd voor tekstintensieve documenten. Wanneer u de leesinterface gebruikt, bevat het antwoord een veld met de naam Operation-Location. Het veld Operation-Location bevat de URL die u moet gebruiken voor de bewerking GetReadResult om toegang te krijgen tot OCR-resultaten..
recognize_printed_text	Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een voor machines bruikbare tekenstroom. Wanneer dit lukt, worden de OCR-resultaten geretourneerd. Bij een fout wordt de foutcode samen met een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage of InternalServerError zijn.
recognize_printed_text_in_stream	Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een voor machines bruikbare tekenstroom. Wanneer dit lukt, worden de OCR-resultaten geretourneerd. Bij een fout wordt de foutcode samen met een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage of InternalServerError zijn.
tag_image	Met deze bewerking wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding. De Computer Vision API kan tags retourneren op basis van objecten, levende wezens, landschappen of acties in afbeeldingen. In tegenstelling tot categorieën zijn tags niet geordend volgens een hiërarchisch classificatiesysteem, maar komen ze overeen met de inhoud van afbeeldingen. Tags kunnen hints bevatten om dubbelzinnigheid te voorkomen of context te bieden, bijvoorbeeld de tag 'ascomycete' kan vergezeld gaan van de hint 'schimmel'. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.
tag_image_in_stream	Met deze bewerking wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding. De Computer Vision-API kan tags retourneren op basis van objecten, levende wezens, landschappen of acties in afbeeldingen. In tegenstelling tot categorieën zijn tags niet geordend volgens een hiërarchisch classificatiesysteem, maar komen ze overeen met de inhoud van afbeeldingen. Tags kunnen hints bevatten om dubbelzinnigheid te voorkomen of context te bieden, bijvoorbeeld de tag 'ascomycete' kan vergezeld gaan van de hint 'schimmel'. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

analyze_image

Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. In uw aanvraag is er een optionele parameter waarmee u kunt kiezen welke functies u wilt retourneren. Standaard worden afbeeldingscategorieën geretourneerd in het antwoord. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

analyze_image(url, visual_features=None, details=None, language='en', description_exclude=None, model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

visual_features

list[str of VisualFeatureTypes]

standaardwaarde: None

Een tekenreeks die aangeeft welke typen visuele functies moeten worden geretourneerd. Meerdere waarden moeten door komma's worden gescheiden. Geldige typen visuele functies zijn onder andere: categorieën: categoriseert afbeeldingsinhoud op basis van een taxonomie die is gedefinieerd in de documentatie. Tags: tagt de afbeelding met een gedetailleerde lijst met woorden die betrekking hebben op de inhoud van de afbeelding. Beschrijving: beschrijft de afbeeldingsinhoud met een volledige Engelse zin. Gezichten: detecteert of gezichten aanwezig zijn. Genereer, indien aanwezig, coördinaten, geslacht en leeftijd. ImageType: hiermee wordt gedetecteerd of de afbeelding een clipart of een lijntekening is. Kleur: bepaalt de accentkleur, de dominante kleur en of een afbeelding zwart&wit is. Volwassene: detecteert of de afbeelding pornografisch van aard is (toont naaktheid of een geslachtsdaad) of bloederig is (toont extreem geweld of bloed). Seksueel suggestieve inhoud (ook wel ongepaste inhoud genoemd) wordt ook gedetecteerd. Objecten: detecteert verschillende objecten in een afbeelding, inclusief de geschatte locatie. Het argument Objecten is alleen beschikbaar in het Engels. Merken: detecteert verschillende merken binnen een afbeelding, inclusief de geschatte locatie. Het argument Merken is alleen beschikbaar in het Engels.

details

list[str of Details]

standaardwaarde: None

Een tekenreeks die aangeeft welke domeinspecifieke details moeten worden geretourneerd. Meerdere waarden moeten door komma's worden gescheiden. Geldige typen visuele functies zijn onder andere: beroemdheden - identificeert beroemdheden als deze worden gedetecteerd in de afbeelding, Oriëntatiepunten - identificeert belangrijke oriëntatiepunten in de afbeelding.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:en - Engels, Standaard. es - Spaans, ja - Japans, pt - Portugees, zh - Vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str of DescriptionExclude]

standaardwaarde: None

Schakel opgegeven domeinmodellen uit bij het genereren van de beschrijving.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardinstelling is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die aan de aanvraag worden toegevoegd

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

ImageAnalysis of ClientRawResponse indien raw=true

Retourtype

ImageAnalysis,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

analyze_image_by_domain

Met deze bewerking wordt inhoud in een afbeelding herkend door een domeinspecifiek model toe te passen. De lijst met domeinspecifieke modellen die worden ondersteund door de Computer Vision API kan worden opgehaald met behulp van de GET-aanvraag /models. Momenteel biedt de API de volgende domeinspecifieke modellen: beroemdheden, oriëntatiepunten. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

analyze_image_by_domain(model, url, language='en', model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

model

str

Vereist

De domeinspecifieke inhoud die moet worden herkend.

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:en - Engels, Standaard. es - Spaans, ja - Japans, pt - Portugees, zh - Vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardinstelling is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die aan de aanvraag worden toegevoegd

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

DomainModelResults of ClientRawResponse indien raw=true

Retourtype

DomainModelResults,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

analyze_image_by_domain_in_stream

Met deze bewerking wordt inhoud in een afbeelding herkend door een domeinspecifiek model toe te passen. De lijst met domeinspecifieke modellen die worden ondersteund door de Computer Vision API kan worden opgehaald met behulp van de GET-aanvraag /models. Momenteel biedt de API de volgende domeinspecifieke modellen: beroemdheden, oriëntatiepunten. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

analyze_image_by_domain_in_stream(model, image, language='en', model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

model

str

Vereist

De domeinspecifieke inhoud die moet worden herkend.

image

Generator

Vereist

Een afbeeldingsstroom.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:en - Engels, Standaard. es - Spaans, ja - Japans, pt - Portugees, zh - Vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardinstelling is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die aan de aanvraag worden toegevoegd

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

DomainModelResults of ClientRawResponse indien raw=true

Retourtype

DomainModelResults,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

analyze_image_in_stream

Met deze bewerking wordt een uitgebreide set visuele functies geëxtraheerd op basis van de inhoud van de afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. In uw aanvraag is er een optionele parameter waarmee u kunt kiezen welke functies u wilt retourneren. Standaard worden afbeeldingscategorieën geretourneerd in het antwoord. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

analyze_image_in_stream(image, visual_features=None, details=None, language='en', description_exclude=None, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

image

Generator

Vereist

Een afbeeldingsstroom.

visual_features

list[str of VisualFeatureTypes]

standaardwaarde: None

Een tekenreeks die aangeeft welke typen visuele functies moeten worden geretourneerd. Meerdere waarden moeten door komma's worden gescheiden. Geldige typen visuele functies zijn onder andere: categorieën: categoriseert afbeeldingsinhoud op basis van een taxonomie die is gedefinieerd in de documentatie. Tags: tagt de afbeelding met een gedetailleerde lijst met woorden die betrekking hebben op de inhoud van de afbeelding. Beschrijving: beschrijft de afbeeldingsinhoud met een volledige Engelse zin. Gezichten: detecteert of gezichten aanwezig zijn. Indien aanwezig, genereer coördinaten, geslacht en leeftijd. ImageType: detecteert of de afbeelding een clipart of een lijntekening is. Kleur: bepaalt de accentkleur, dominante kleur en of een afbeelding zwart&wit is. Volwassene: detecteert of de afbeelding pornografisch van aard is (toont naaktheid of een sekshandeling) of bloederig is (toont extreem geweld of bloed). Seksueel suggestieve inhoud (ook wel ongepaste inhoud genoemd) wordt ook gedetecteerd. Objecten: detecteert verschillende objecten in een afbeelding, inclusief de geschatte locatie. Het argument Objecten is alleen beschikbaar in het Engels. Merken: detecteert verschillende merken in een afbeelding, inclusief de locatie bij benadering. Het argument Merken is alleen beschikbaar in het Engels.

details

list[str of Details]

standaardwaarde: None

Een tekenreeks die aangeeft welke domeinspecifieke details moeten worden geretourneerd. Meerdere waarden moeten door komma's worden gescheiden. Geldige typen visuele functies zijn onder andere: Beroemdheden - identificeert beroemdheden als deze worden gedetecteerd in de afbeelding, Oriëntatiepunten - identificeert belangrijke oriëntatiepunten in de afbeelding.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:nl - Engels, standaard. es - Spaans, ja - Japans, pt - Portugees, zh - vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str of DescriptionExclude]

standaardwaarde: None

Schakel opgegeven domeinmodellen uit bij het genereren van de beschrijving.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

ImageAnalysis of ClientRawResponse indien raw=true

Retourtype

ImageAnalysis,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

close

Sluit de client als keep_alive Waar is.

close() -> None

Uitzonderingen

ComputerVisionErrorResponseException

describe_image

Deze bewerking genereert een beschrijving van een afbeelding in door mensen leesbare taal met volledige zinnen. De beschrijving is gebaseerd op een verzameling inhoudstags, die ook worden geretourneerd door de bewerking. Er kan meer dan één beschrijving worden gegenereerd voor elke afbeelding. Beschrijvingen worden geordend op hun betrouwbaarheidsscore. Beschrijvingen kunnen resultaten bevatten van beroemdheids- en oriëntatiepuntdomeinmodellen, indien van toepassing. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

describe_image(url, max_candidates=1, language='en', description_exclude=None, model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

max_candidates

int

standaardwaarde: 1

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd. De standaardwaarde is 1.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:nl - Engels, standaard. es - Spaans, ja - Japans, pt - Portugees, zh - vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str of DescriptionExclude]

standaardwaarde: None

Schakel opgegeven domeinmodellen uit bij het genereren van de beschrijving.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

ImageDescription of ClientRawResponse indien raw=true

Retourtype

ImageDescription,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

describe_image_in_stream

Deze bewerking genereert een beschrijving van een afbeelding in door mensen leesbare taal met volledige zinnen. De beschrijving is gebaseerd op een verzameling inhoudstags, die ook worden geretourneerd door de bewerking. Er kan meer dan één beschrijving worden gegenereerd voor elke afbeelding. Beschrijvingen worden geordend op hun betrouwbaarheidsscore. Beschrijvingen kunnen resultaten bevatten van beroemdheids- en oriëntatiepuntdomeinmodellen, indien van toepassing. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

describe_image_in_stream(image, max_candidates=1, language='en', description_exclude=None, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

image

Generator

Vereist

Een afbeeldingsstroom.

max_candidates

int

standaardwaarde: 1

Maximum aantal kandidaatbeschrijvingen dat moet worden geretourneerd. De standaardwaarde is 1.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:nl - Engels, standaard. es - Spaans, ja - Japans, pt - Portugees, zh - vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str of DescriptionExclude]

standaardwaarde: None

Schakel opgegeven domeinmodellen uit bij het genereren van de beschrijving.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

ImageDescription of ClientRawResponse indien raw=true

Retourtype

ImageDescription,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

detect_objects

Hiermee wordt objectdetectie uitgevoerd op de opgegeven afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

detect_objects(url, model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

DetectResult of ClientRawResponse indien raw=true

Retourtype

DetectResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

detect_objects_in_stream

Hiermee wordt objectdetectie uitgevoerd op de opgegeven afbeelding. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

detect_objects_in_stream(image, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

image

Generator

Vereist

Een afbeeldingsstroom.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

DetectResult of ClientRawResponse indien raw=true

Retourtype

DetectResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

generate_thumbnail

Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte. Standaard wordt met de service de afbeelding geanalyseerd, het interessegebied bepaald en op basis van het interessegebied coördinaten voor slim bijsnijden gegenereerd. Slim bijsnijden helpt wanneer u een hoogte-breedteverhouding opgeeft die afwijkt van die van de invoerafbeelding. Een geslaagd antwoord bevat het binaire bestand voor de miniatuurafbeelding. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan een van de volgende zijn: InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError.

generate_thumbnail(width, height, url, smart_cropping=False, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

width

int

Vereist

Breedte van de miniatuur, in pixels. Het moet tussen 1 en 1024 zijn. Aanbevolen minimaal 50.

height

int

Vereist

Hoogte van de miniatuur, in pixels. Het moet tussen 1 en 1024 zijn. Aanbevolen minimaal 50.

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

smart_cropping

bool

standaardwaarde: False

Booleaanse vlag voor het inschakelen van slim bijsnijden.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

object of ClientRawResponse indien raw=true

Retourtype

Generator,

ClientRawResponse

Uitzonderingen

HttpOperationError

generate_thumbnail_in_stream

Met deze bewerking wordt een miniatuurafbeelding gegenereerd met de door de gebruiker opgegeven breedte en hoogte. Standaard wordt met de service de afbeelding geanalyseerd, het interessegebied bepaald en op basis van het interessegebied coördinaten voor slim bijsnijden gegenereerd. Slim bijsnijden helpt wanneer u een hoogte-breedteverhouding opgeeft die afwijkt van die van de invoerafbeelding. Een geslaagd antwoord bevat het binaire bestand voor de miniatuurafbeelding. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan een van de volgende zijn: InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError.

generate_thumbnail_in_stream(width, height, image, smart_cropping=False, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

width

int

Vereist

Breedte van de miniatuur, in pixels. Het moet tussen 1 en 1024 zijn. Aanbevolen minimaal 50.

height

int

Vereist

Hoogte van de miniatuur, in pixels. Het moet tussen 1 en 1024 zijn. Aanbevolen minimaal 50.

image

Generator

Vereist

Een afbeeldingsstroom.

smart_cropping

bool

standaardwaarde: False

Booleaanse vlag voor het inschakelen van slim bijsnijden.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

object of ClientRawResponse indien raw=true

Retourtype

Generator,

ClientRawResponse

Uitzonderingen

HttpOperationError

get_area_of_interest

Met deze bewerking wordt een begrenzingsvak rond het belangrijkste gebied van de afbeelding geretourneerd. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError zijn.

get_area_of_interest(url, model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

AreaOfInterestResult of ClientRawResponse indien raw=true

Retourtype

AreaOfInterestResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

get_area_of_interest_in_stream

Met deze bewerking wordt een begrenzingsvak rond het belangrijkste gebied van de afbeelding geretourneerd. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te bepalen wat er mis is gegaan. Bij een fout worden de foutcode en een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout of InternalServerError zijn.

get_area_of_interest_in_stream(image, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

image

Generator

Vereist

Een afbeeldingsstroom.

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

AreaOfInterestResult of ClientRawResponse indien raw=true

Retourtype

AreaOfInterestResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

get_read_result

Deze interface wordt gebruikt voor het ophalen van OCR-resultaten van de leesbewerking. De URL naar deze interface moet worden opgehaald uit het veld 'Operation-Location' dat wordt geretourneerd uit de leesinterface.

get_read_result(operation_id, custom_headers=None, raw=False, **operation_config)

Parameters

operation_id

str

Vereist

Id van leesbewerking die wordt geretourneerd in het antwoord van de leesinterface.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

ReadOperationResult of ClientRawResponse indien raw=true

Retourtype

ReadOperationResult,

ClientRawResponse

Uitzonderingen

ComputerVisionOcrErrorException

list_models

Deze bewerking retourneert de lijst met domeinspecifieke modellen die worden ondersteund door de Computer Vision-API. Momenteel ondersteunt de API de volgende domeinspecifieke modellen: celebrity recognizer, landmark recognizer. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

list_models(custom_headers=None, raw=False, **operation_config)

Parameters

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

ListModelsResult of ClientRawResponse indien raw=true

Retourtype

ListModelsResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

read

Gebruik deze interface om het resultaat van een leesbewerking te verkrijgen, waarbij gebruik wordt gemaakt van de state-of-the-art OCR-algoritmen (Optical Character Recognition) die zijn geoptimaliseerd voor tekstintensieve documenten. Wanneer u de leesinterface gebruikt, bevat het antwoord een veld met de naam Operation-Location. Het veld Operation-Location bevat de URL die u moet gebruiken voor de bewerking GetReadResult om toegang te krijgen tot OCR-resultaten..

read(url, language=None, pages=None, model_version='latest', reading_order='basic', custom_headers=None, raw=False, **operation_config)

Parameters

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

language

str of OcrDetectionLanguage

standaardwaarde: None

De BCP-47-taalcode van de tekst in het document. Read ondersteunt automatische taalidentificatie en meertalige documenten, dus geef alleen een taalcode op als u wilt afdwingen dat het document in die specifieke taal wordt verwerkt. Zie https://aka.ms/ocr-languages voor een lijst met ondersteunde talen. Mogelijke waarden zijn: 'af', 'ast', 'bi', 'br', 'ca', 'ceb', 'ch', 'co', 'crh', 'cs', 'csb', 'da', 'de', 'en', 'es', 'et', 'eu', 'fi', 'fil', 'fj', 'fr', 'fur', 'fy', 'ga', 'gd', 'gil', 'gl', 'gv', 'hni', 'hsb', 'ht', 'hu', 'ia', 'id', 'it', 'iu', 'ja', 'jv', 'kaa', 'kac' 'kea', 'kha', 'kl', 'ko', 'ku', 'kw', 'lb', 'ms', 'mww', 'nap', 'nl', 'no', 'oc', 'pl', 'pt', 'quc', 'rm', 'sco', 'sl', 'sq', 'sv', 'sw', 'tet', 'tr', 'tt', 'uz', 'vo', 'wae', 'yua', 'za', 'zh-Hans', 'zh-Hant', 'zu'

pages

list[str]

standaardwaarde: None

Aangepaste paginanummers voor documenten met meerdere pagina's (PDF/TIFF) voeren het aantal pagina's in dat u een OCR-resultaat wilt ophalen. Gebruik een afbreekstreepje voor een reeks pagina's. Scheid elke pagina of elk bereik met een komma.

model_version

str

standaardwaarde: latest

Optionele parameter voor het opgeven van de versie van het OCR-model dat wordt gebruikt voor tekstextractie. Geaccepteerde waarden zijn: 'latest', 'latest-preview', '2021-04-12'. De standaardwaarde is 'nieuwste'.

reading_order

str

standaardwaarde: basic

Optionele parameter om op te geven welk algoritme voor de leesvolgorde moet worden toegepast bij het ordenen van de extraheren van tekstelementen. Kan 'basic' of 'natural' zijn. Wordt standaard ingesteld op 'basic' als deze niet is opgegeven

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

None of ClientRawResponse indien raw=true

Retourtype

None,

ClientRawResponse

Uitzonderingen

ComputerVisionOcrErrorException

read_in_stream

Gebruik deze interface om het resultaat van een leesbewerking te verkrijgen, waarbij gebruik wordt gemaakt van de state-of-the-art OCR-algoritmen (Optical Character Recognition) die zijn geoptimaliseerd voor tekstintensieve documenten. Wanneer u de leesinterface gebruikt, bevat het antwoord een veld met de naam Operation-Location. Het veld Operation-Location bevat de URL die u moet gebruiken voor de bewerking GetReadResult om toegang te krijgen tot OCR-resultaten..

read_in_stream(image, language=None, pages=None, model_version='latest', reading_order='basic', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

image

Generator

Vereist

Een afbeeldingsstroom.

language

str of OcrDetectionLanguage

standaardwaarde: None

De BCP-47-taalcode van de tekst in het document. Read ondersteunt automatische taalidentificatie en meertalige documenten, dus geef alleen een taalcode op als u wilt afdwingen dat het document in die specifieke taal wordt verwerkt. Zie https://aka.ms/ocr-languages voor een lijst met ondersteunde talen. Mogelijke waarden zijn: 'af', 'ast', 'bi', 'br', 'ca', 'ceb', 'ch', 'co', 'crh', 'cs', 'csb', 'da', 'de', 'en', 'es', 'et', 'eu', 'fi', 'fil', 'fj', 'fr', 'fur', 'fy', 'ga', 'gd', 'gil', 'gl', 'gv', 'hni', 'hsb', 'ht', 'hu', 'ia', 'id', 'it', 'iu', 'ja', 'jv', 'kaa', 'kac' 'kea', 'kha', 'kl', 'ko', 'ku', 'kw', 'lb', 'ms', 'mww', 'nap', 'nl', 'no', 'oc', 'pl', 'pt', 'quc', 'rm', 'sco', 'sl', 'sq', 'sv', 'sw', 'tet', 'tr', 'tt', 'uz', 'vo', 'wae', 'yua', 'za', 'zh-Hans', 'zh-Hant', 'zu'

pages

list[str]

standaardwaarde: None

Aangepaste paginanummers voor documenten met meerdere pagina's (PDF/TIFF) voeren het aantal pagina's in dat u een OCR-resultaat wilt ophalen. Gebruik een afbreekstreepje voor een reeks pagina's. Scheid elke pagina of elk bereik met een komma.

model_version

str

standaardwaarde: latest

Optionele parameter voor het opgeven van de versie van het OCR-model dat wordt gebruikt voor tekstextractie. Geaccepteerde waarden zijn: 'latest', 'latest-preview', '2021-04-12'. De standaardwaarde is 'nieuwste'.

reading_order

str

standaardwaarde: basic

Optionele parameter om op te geven welk algoritme voor de leesvolgorde moet worden toegepast bij het ordenen van de extraheren van tekstelementen. Kan 'basic' of 'natural' zijn. Wordt standaard ingesteld op 'basic' als deze niet is opgegeven

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

None of ClientRawResponse indien raw=true

Retourtype

None,

ClientRawResponse

Uitzonderingen

ComputerVisionOcrErrorException

recognize_printed_text

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een voor machines bruikbare tekenstroom. Wanneer dit lukt, worden de OCR-resultaten geretourneerd. Bij een fout wordt de foutcode samen met een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage of InternalServerError zijn.

recognize_printed_text(url, detect_orientation=True, language='unk', model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

detect_orientation

bool

standaardwaarde: True

Hiermee geeft u aan of de tekststand in de afbeelding wordt gedetecteerd. Met detectOrientation=true probeert de OCR-service de afdrukstand van de afbeelding te detecteren en te corrigeren voordat deze verder wordt verwerkt (bijvoorbeeld als deze ondersteboven is).

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

language

str of OcrLanguages

standaardwaarde: unk

De BCP-47-taalcode van de tekst die in de afbeelding moet worden gedetecteerd. De standaardwaarde is 'unk'. Mogelijke waarden zijn: 'unk', 'zh-Hans', 'zh-Hant', 'cs', 'da', 'nl', 'en', 'fi', 'fr', 'de', 'el', 'hu', 'it', 'ja', 'ko', 'nb', 'pl', 'pt', 'ru', 'es', 'sv', 'tr', 'ar', 'ro', 'sr-Cyrl', 'sr-Latn', 'sk'

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

OcrResult of ClientRawResponse indien raw=true

Retourtype

OcrResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

recognize_printed_text_in_stream

Optical Character Recognition (OCR) detecteert tekst in een afbeelding en extraheert de herkende tekens in een voor machines bruikbare tekenstroom. Wanneer dit lukt, worden de OCR-resultaten geretourneerd. Bij een fout wordt de foutcode samen met een foutbericht geretourneerd. De foutcode kan InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage of InternalServerError zijn.

recognize_printed_text_in_stream(image, detect_orientation=True, language='unk', model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

detect_orientation

bool

standaardwaarde: True

Hiermee geeft u aan of de tekststand in de afbeelding wordt gedetecteerd. Met detectOrientation=true probeert de OCR-service de afdrukstand van de afbeelding te detecteren en te corrigeren voordat deze verder wordt verwerkt (bijvoorbeeld als deze ondersteboven is).

image

Generator

Vereist

Een afbeeldingsstroom.

language

str of OcrLanguages

standaardwaarde: unk

De BCP-47-taalcode van de tekst die in de afbeelding moet worden gedetecteerd. De standaardwaarde is 'unk'. Mogelijke waarden zijn: 'unk', 'zh-Hans', 'zh-Hant', 'cs', 'da', 'nl', 'en', 'fi', 'fr', 'de', 'el', 'hu', 'it', 'ja', 'ko', 'nb', 'pl', 'pt', 'ru', 'es', 'sv', 'tr', 'ar', 'ro', 'sr-Cyrl', 'sr-Latn', 'sk'

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

OcrResult of ClientRawResponse indien raw=true

Retourtype

OcrResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

tag_image

Met deze bewerking wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding. De Computer Vision API kan tags retourneren op basis van objecten, levende wezens, landschappen of acties in afbeeldingen. In tegenstelling tot categorieën zijn tags niet geordend volgens een hiërarchisch classificatiesysteem, maar komen ze overeen met de inhoud van afbeeldingen. Tags kunnen hints bevatten om dubbelzinnigheid te voorkomen of context te bieden, bijvoorbeeld de tag 'ascomycete' kan vergezeld gaan van de hint 'schimmel'. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

tag_image(url, language='en', model_version='latest', custom_headers=None, raw=False, **operation_config)

Parameters

url

str

Vereist

Openbaar bereikbare URL van een afbeelding.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:nl - Engels, standaard. es - Spaans, ja - Japans, pt - Portugees, zh - vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardwaarde is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die worden toegevoegd aan de aanvraag

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

TagResult of ClientRawResponse indien raw=true

Retourtype

TagResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException

tag_image_in_stream

Met deze bewerking wordt een lijst met woorden of tags gegenereerd die relevant zijn voor de inhoud van de opgegeven afbeelding. De Computer Vision-API kan tags retourneren op basis van objecten, levende wezens, landschappen of acties in afbeeldingen. In tegenstelling tot categorieën zijn tags niet geordend volgens een hiërarchisch classificatiesysteem, maar komen ze overeen met de inhoud van afbeeldingen. Tags kunnen hints bevatten om dubbelzinnigheid te voorkomen of context te bieden, bijvoorbeeld de tag 'ascomycete' kan vergezeld gaan van de hint 'schimmel'. Er worden twee invoermethoden ondersteund: (1) Een afbeelding uploaden of (2) het opgeven van een afbeeldings-URL. Een geslaagd antwoord wordt geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er fout is gegaan.

tag_image_in_stream(image, language='en', model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

image

Generator

Vereist

Een afbeeldingsstroom.

language

str

standaardwaarde: en

De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Ondersteunde talen:en - Engels, Standaard. es - Spaans, ja - Japans, pt - Portugees, zh - Vereenvoudigd Chinees. Mogelijke waarden zijn: 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

standaardwaarde: latest

Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'laatste', '2021-04-01'. De standaardinstelling is 'nieuwste'.

custom_headers

dict

standaardwaarde: None

headers die aan de aanvraag worden toegevoegd

raw

bool

standaardwaarde: False

retourneert het directe antwoord naast het gedeserialiseerde antwoord

callback

Callable[<xref:Bytes>, <xref:response=None>]

standaardwaarde: None

Wanneer dit is opgegeven, wordt aangeroepen met elk segment gegevens dat wordt gestreamd. De callback moet twee argumenten hebben: de bytes van het huidige gegevenssegment en het antwoordobject. Als de gegevens worden geüpload, is het antwoord Geen.

operation_config

Vereist

Bewerkingsconfiguratie overschrijft.

Retouren

TagResult of ClientRawResponse indien raw=true

Retourtype

TagResult,

ClientRawResponse

Uitzonderingen

ComputerVisionErrorResponseException