ComputerVisionClient Classe

L’API Vision par ordinateur fournit des algorithmes de pointe pour traiter les images et retourner des informations. Par exemple, il peut être utilisé pour déterminer si une image contient du contenu mature, ou il peut être utilisé pour rechercher tous les visages d’une image. Elle comprend également d’autres fonctionnalités comme l’estimation des couleurs dominantes et d’accentuation, le classement du contenu des images et la description d’une image avec des phrases complètes en français. De plus, elle peut également générer de façon intelligente des miniatures d’images pour afficher efficacement des images de grande taille.

Héritage

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

ComputerVisionClient

SDKClient

ComputerVisionClient

Constructeur

ComputerVisionClient(endpoint, credentials)

Paramètres

endpoint

str

Obligatoire

Points de terminaison Cognitive Services pris en charge.

credentials

None

Obligatoire

Informations d’identification de l’abonnement qui identifient de manière unique l’abonnement client.

Variables

config

ComputerVisionClientConfiguration

Configuration pour le client.

Méthodes

analyze_image	Cette opération extrait un ensemble riche de caractéristiques visuelles basées sur le contenu de l’image. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Dans votre demande, un paramètre facultatif vous permet de choisir les fonctionnalités à retourner. Par défaut, les catégories d’images sont retournées dans la réponse. Une réponse réussie est retournée dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
analyze_image_by_domain	Cette opération reconnaît le contenu au sein d’une image en appliquant un modèle spécifique à un domaine. La liste des modèles spécifiques à un domaine pris en charge par l’API Vision par ordinateur peut être récupérée à l’aide de la requête GET /models. Actuellement, l’API fournit les modèles propres au domaine suivants : célébrités, des points de repère. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
analyze_image_by_domain_in_stream	Cette opération reconnaît le contenu au sein d’une image en appliquant un modèle spécifique à un domaine. La liste des modèles spécifiques à un domaine pris en charge par l’API Vision par ordinateur peut être récupérée à l’aide de la requête GET /models. Actuellement, l’API fournit les modèles propres au domaine suivants : célébrités, des points de repère. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
analyze_image_in_stream	Cette opération extrait un ensemble riche de caractéristiques visuelles basées sur le contenu de l’image. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Dans votre demande, il existe un paramètre facultatif pour vous permettre de choisir les fonctionnalités à retourner. Par défaut, les catégories d’images sont retournées dans la réponse. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
close	Fermez le client si keep_alive a la valeur True.
describe_image	Cette opération génère une description d’une image dans un langage intelligible avec des phrases complètes. La description est basée sur une collection de balises de contenu, qui sont également retournées par l’opération. Plus d’une description peut être générée pour chaque image. Les descriptions sont triées par score de confiance. Les descriptions peuvent inclure des résultats de modèles de domaine de célébrités et de repères, le cas échéant. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
describe_image_in_stream	Cette opération génère une description d’une image dans un langage intelligible avec des phrases complètes. La description est basée sur une collection de balises de contenu, qui sont également retournées par l’opération. Plus d’une description peut être générée pour chaque image. Les descriptions sont triées par score de confiance. Les descriptions peuvent inclure des résultats de modèles de domaine de célébrités et de repères, le cas échéant. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
detect_objects	Effectue la détection d’objets sur l’image spécifiée. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
detect_objects_in_stream	Effectue la détection d’objets sur l’image spécifiée. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
generate_thumbnail	Cette opération génère une image miniature avec la hauteur et la largeur spécifiées par l’utilisateur. Par défaut, le service analyse l’image, identifie la région d’intérêt et génère des coordonnées de rognage intelligentes basées sur le retour sur la région d’intérêt. Le rognage intelligent vous permet de spécifier des proportions différentes de celles de l’image d’entrée. Une réponse correcte contient l’image miniature au format binaire. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.
generate_thumbnail_in_stream	Cette opération génère une image miniature avec la hauteur et la largeur spécifiées par l’utilisateur. Par défaut, le service analyse l’image, identifie la région d’intérêt et génère des coordonnées de rognage intelligentes basées sur le retour sur la région d’intérêt. Le rognage intelligent vous permet de spécifier des proportions différentes de celles de l’image d’entrée. Une réponse correcte contient l’image miniature au format binaire. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.
get_area_of_interest	Cette opération retourne un cadre englobant la zone la plus importante de l’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.
get_area_of_interest_in_stream	Cette opération retourne un cadre englobant la zone la plus importante de l’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.
get_read_result	Cette interface est utilisée pour obtenir les résultats OCR de lecture. L’URL de cette interface doit être récupérée à partir du champ « Operation-Location » retourné par l’interface de lecture.
list_models	Cette opération renvoie la liste des modèles propres à un domaine qui sont pris en charge par l’API Vision par ordinateur. Actuellement, l’API prend en charge les modèles propres au domaine suivants : module de reconnaissance de célébrités, module de reconnaissance d’éléments géographiques. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
read	Utilisez cette interface pour obtenir le résultat d’une opération de lecture, en utilisant les algorithmes de reconnaissance optique de caractères (OCR) de pointe optimisés pour les documents volumineux. Lorsque vous utilisez l’interface Read, la réponse contient un champ appelé « Operation-Location ». Le champ « Operation-Location » contient l’URL que vous devez utiliser pour votre opération « GetReadResult » afin d’accéder aux résultats de l’OCR..
read_in_stream	Utilisez cette interface pour obtenir le résultat d’une opération de lecture, en utilisant les algorithmes de reconnaissance optique de caractères (OCR) de pointe optimisés pour les documents volumineux. Lorsque vous utilisez l’interface Read, la réponse contient un champ appelé « Operation-Location ». Le champ « Operation-Location » contient l’URL que vous devez utiliser pour votre opération « GetReadResult » afin d’accéder aux résultats de l’OCR..
recognize_printed_text	Avec la reconnaissance optique de caractères (OCR), détectez du texte dans une image et extrayez les caractères reconnus dans un flux de caractères exploitable automatiquement. En cas de réussite, les résultats de l’OCR sont retournés. En cas d’échec, le code d’erreur ainsi qu’un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedImage, NotSupportedLanguage ou InternalServerError.
recognize_printed_text_in_stream	Avec la reconnaissance optique de caractères (OCR), détectez du texte dans une image et extrayez les caractères reconnus dans un flux de caractères exploitable automatiquement. En cas de réussite, les résultats de l’OCR sont retournés. En cas d’échec, le code d’erreur ainsi qu’un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedImage, NotSupportedLanguage ou InternalServerError.
tag_image	Cette opération génère une liste de mots, ou balises, qui sont pertinents pour le contenu de l’image fournie. L’API Vision par ordinateur peut retourner des balises basées sur les objets, les êtres vivants, les paysages ou les actions trouvées dans les images. Contrairement aux catégories, les balises ne sont pas organisées selon un système de classification hiérarchique, mais correspondent au contenu de l’image. Les étiquettes peuvent contenir des indices pour éviter toute ambiguïté ou fournir un contexte, par exemple l'étiquette "ascomycète" peut être accompagnée de l'indice "fungus". Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.
tag_image_in_stream	Cette opération génère une liste de mots, ou balises, qui sont pertinents pour le contenu de l’image fournie. L’API Vision par ordinateur peut retourner des balises basées sur les objets, les êtres vivants, les paysages ou les actions trouvées dans les images. Contrairement aux catégories, les balises ne sont pas organisées selon un système de classification hiérarchique, mais correspondent au contenu de l’image. Les étiquettes peuvent contenir des indices pour éviter toute ambiguïté ou fournir un contexte, par exemple l'étiquette "ascomycète" peut être accompagnée de l'indice "fungus". Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

analyze_image

Cette opération extrait un ensemble riche de caractéristiques visuelles basées sur le contenu de l’image. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Dans votre demande, un paramètre facultatif vous permet de choisir les fonctionnalités à retourner. Par défaut, les catégories d’images sont retournées dans la réponse. Une réponse réussie est retournée dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

url

str

Obligatoire

URL accessible publiquement d’une image.

visual_features

list[str ou VisualFeatureTypes]

valeur par défaut: None

Chaîne indiquant les types de caractéristiques visuelles à retourner. Plusieurs valeurs doivent être séparées par des virgules. Les types de caractéristiques visuelles valides incluent : Catégories : catégorise le contenu de l’image selon une taxonomie définie dans la documentation. Balises : étiquette l’image avec une liste détaillée de mots liés au contenu de l’image. Description : décrit le contenu de l’image avec une phrase en anglais complète. Visages : détecte si des visages sont présents. Si tel est le cas, génère des coordonnées, ainsi que l’âge et le sexe. ImageType : détecte si l’image est de type clipart ou un dessin au trait. Couleur : détermine la couleur d’accentuation, la couleur dominante et si une image est noire&blanche. Adulte - détecte si l’image est pornographique dans la nature (représente la nudité ou un acte sexuel), ou est gory (représente la violence extrême ou le sang). Le contenu sexuellement suggestif (ou contenu osé) est également détecté. Objets : détecte différents objets dans une image, y compris l’emplacement approximatif. L’argument Objects est disponible uniquement en anglais. Marques : détecte différentes marques dans une image, y compris l’emplacement approximatif. L’argument Brands est disponible uniquement en anglais.

details

list[str ou Details]

valeur par défaut: None

Chaîne indiquant les détails spécifiques au domaine à retourner. Plusieurs valeurs doivent être séparées par des virgules. Les types de caractéristiques visuelles valides sont les suivants : Célébrités - identifie les célébrités si elles sont détectées dans l’image, Repères - identifie les points de repère notables dans l’image.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - anglais, par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles incluent : 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str ou DescriptionExclude]

valeur par défaut: None

Désactivez les modèles de domaine spécifiés lors de la génération de la description.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe à côté de la réponse désérialisée

operation_config

Obligatoire

La configuration de l’opération remplace.

Retours

ImageAnalysis ou ClientRawResponse si raw=true

Type de retour

ImageAnalysis,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

analyze_image_by_domain

Cette opération reconnaît le contenu au sein d’une image en appliquant un modèle spécifique à un domaine. La liste des modèles spécifiques à un domaine pris en charge par l’API Vision par ordinateur peut être récupérée à l’aide de la requête GET /models. Actuellement, l’API fournit les modèles propres au domaine suivants : célébrités, des points de repère. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

model

str

Obligatoire

Contenu spécifique au domaine à reconnaître.

url

str

Obligatoire

URL accessible publiquement d’une image.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - anglais, par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles incluent : 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe à côté de la réponse désérialisée

operation_config

Obligatoire

La configuration de l’opération remplace.

Retours

DomainModelResults ou ClientRawResponse si raw=true

Type de retour

DomainModelResults,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

analyze_image_by_domain_in_stream

Cette opération reconnaît le contenu au sein d’une image en appliquant un modèle spécifique à un domaine. La liste des modèles spécifiques à un domaine pris en charge par l’API Vision par ordinateur peut être récupérée à l’aide de la requête GET /models. Actuellement, l’API fournit les modèles propres au domaine suivants : célébrités, des points de repère. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

model

str

Obligatoire

Contenu spécifique au domaine à reconnaître.

image

Generator

Obligatoire

Flux d’images.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - anglais, par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles incluent : 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe à côté de la réponse désérialisée

callback

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

valeur par défaut: None

Lorsqu’il est spécifié, est appelé avec chaque segment de données qui est diffusé en continu. Le rappel doit prendre deux arguments : les octets du segment actuel de données et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

La configuration de l’opération remplace.

Retours

DomainModelResults ou ClientRawResponse si raw=true

Type de retour

DomainModelResults,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

analyze_image_in_stream

Cette opération extrait un ensemble riche de caractéristiques visuelles basées sur le contenu de l’image. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Dans votre demande, il existe un paramètre facultatif pour vous permettre de choisir les fonctionnalités à retourner. Par défaut, les catégories d’images sont retournées dans la réponse. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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)

Paramètres

image

Generator

Obligatoire

Flux d’images.

visual_features

list[str ou VisualFeatureTypes]

valeur par défaut: None

Chaîne indiquant les types de caractéristiques visuelles à retourner. Plusieurs valeurs doivent être séparées par des virgules. Les types de caractéristiques visuelles valides incluent : Catégories : catégorise le contenu de l’image selon une taxonomie définie dans la documentation. Balises : étiquette l’image avec une liste détaillée de mots liés au contenu de l’image. Description : décrit le contenu de l’image avec une phrase en anglais complète. Visages : détecte si des visages sont présents. Si tel est le cas, génère des coordonnées, ainsi que l’âge et le sexe. ImageType : détecte si l’image est de type clipart ou un dessin au trait. Couleur : détermine la couleur d’accentuation, la couleur dominante et si une image est blanche noire&. Adulte - détecte si l’image est pornographique dans la nature (représente la nudité ou un acte sexuel), ou est gory (représente une violence extrême ou du sang). Le contenu sexuellement suggestif (ou contenu osé) est également détecté. Objets : détecte différents objets dans une image, y compris l’emplacement approximatif. L’argument Objects est disponible uniquement en anglais. Marques : détecte différentes marques au sein d’une image, y compris l’emplacement approximatif. L’argument Brands est disponible uniquement en anglais.

details

list[str ou Details]

valeur par défaut: None

Chaîne indiquant les détails spécifiques au domaine à retourner. Plusieurs valeurs doivent être séparées par des virgules. Les types de caractéristiques visuelles valides incluent : Célébrités - identifie les célébrités si elles sont détectées dans l’image, Repères - identifie les points de repère notables dans l’image.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - Anglais, Par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles sont les suivantes : 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str ou DescriptionExclude]

valeur par défaut: None

Désactivez les modèles de domaine spécifiés lors de la génération de la description.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

ImageAnalysis ou ClientRawResponse si raw=true

Type de retour

ImageAnalysis,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

close

Fermez le client si keep_alive a la valeur True.

close() -> None

Exceptions

ComputerVisionErrorResponseException

describe_image

Cette opération génère une description d’une image dans un langage intelligible avec des phrases complètes. La description est basée sur une collection de balises de contenu, qui sont également retournées par l’opération. Plus d’une description peut être générée pour chaque image. Les descriptions sont triées par score de confiance. Les descriptions peuvent inclure des résultats de modèles de domaine de célébrités et de repères, le cas échéant. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

url

str

Obligatoire

URL accessible publiquement d’une image.

max_candidates

int

valeur par défaut: 1

Nombre maximal de descriptions de candidats à retourner. La valeur par défaut est 1.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - Anglais, Par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles sont les suivantes : 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str ou DescriptionExclude]

valeur par défaut: None

Désactivez les modèles de domaine spécifiés lors de la génération de la description.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

ImageDescription ou ClientRawResponse si raw=true

Type de retour

ImageDescription,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

describe_image_in_stream

Cette opération génère une description d’une image dans un langage intelligible avec des phrases complètes. La description est basée sur une collection de balises de contenu, qui sont également retournées par l’opération. Plus d’une description peut être générée pour chaque image. Les descriptions sont triées par score de confiance. Les descriptions peuvent inclure des résultats de modèles de domaine de célébrités et de repères, le cas échéant. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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)

Paramètres

image

Generator

Obligatoire

Flux d’images.

max_candidates

int

valeur par défaut: 1

Nombre maximal de descriptions de candidats à retourner. La valeur par défaut est 1.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - Anglais, Par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles sont les suivantes : 'en', 'es', 'ja', 'pt', 'zh'

description_exclude

list[str ou DescriptionExclude]

valeur par défaut: None

Désactivez les modèles de domaine spécifiés lors de la génération de la description.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

ImageDescription ou ClientRawResponse si raw=true

Type de retour

ImageDescription,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

detect_objects

Effectue la détection d’objets sur l’image spécifiée. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

url

str

Obligatoire

URL accessible publiquement d’une image.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

DetectResult ou ClientRawResponse si raw=true

Type de retour

DetectResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

detect_objects_in_stream

Effectue la détection d’objets sur l’image spécifiée. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

image

Generator

Obligatoire

Flux d’images.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

DetectResult ou ClientRawResponse si raw=true

Type de retour

DetectResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

generate_thumbnail

Cette opération génère une image miniature avec la hauteur et la largeur spécifiées par l’utilisateur. Par défaut, le service analyse l’image, identifie la région d’intérêt et génère des coordonnées de rognage intelligentes basées sur le retour sur la région d’intérêt. Le rognage intelligent vous permet de spécifier des proportions différentes de celles de l’image d’entrée. Une réponse correcte contient l’image miniature au format binaire. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.

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

Paramètres

width

int

Obligatoire

Largeur de la miniature, en pixels. Il doit être compris entre 1 et 1024. Minimum recommandé de 50.

height

int

Obligatoire

Hauteur de la miniature, en pixels. Il doit être compris entre 1 et 1024. Minimum recommandé de 50.

url

str

Obligatoire

URL accessible publiquement d’une image.

smart_cropping

bool

valeur par défaut: False

Indicateur booléen pour activer le rognage intelligent.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

object ou ClientRawResponse si raw=true

Type de retour

Generator,

ClientRawResponse

Exceptions

HttpOperationError

generate_thumbnail_in_stream

Cette opération génère une image miniature avec la hauteur et la largeur spécifiées par l’utilisateur. Par défaut, le service analyse l’image, identifie la région d’intérêt et génère des coordonnées de rognage intelligentes basées sur le retour sur la région d’intérêt. Le rognage intelligent vous permet de spécifier des proportions différentes de celles de l’image d’entrée. Une réponse correcte contient l’image miniature au format binaire. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.

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

Paramètres

width

int

Obligatoire

Largeur de la miniature, en pixels. Il doit être compris entre 1 et 1024. Minimum recommandé de 50.

height

int

Obligatoire

Hauteur de la miniature, en pixels. Il doit être compris entre 1 et 1024. Minimum recommandé de 50.

image

Generator

Obligatoire

Flux d’images.

smart_cropping

bool

valeur par défaut: False

Indicateur booléen pour activer le rognage intelligent.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

object ou ClientRawResponse si raw=true

Type de retour

Generator,

ClientRawResponse

Exceptions

HttpOperationError

get_area_of_interest

Cette opération retourne un cadre englobant la zone la plus importante de l’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.

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

Paramètres

url

str

Obligatoire

URL accessible publiquement d’une image.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

AreaOfInterestResult ou ClientRawResponse si raw=true

Type de retour

AreaOfInterestResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

get_area_of_interest_in_stream

Cette opération retourne un cadre englobant la zone la plus importante de l’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à déterminer ce qui s’est passé. En cas d’échec, le code d’erreur et un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.

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

Paramètres

image

Generator

Obligatoire

Flux d’images.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

AreaOfInterestResult ou ClientRawResponse si raw=true

Type de retour

AreaOfInterestResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

get_read_result

Cette interface est utilisée pour obtenir les résultats OCR de lecture. L’URL de cette interface doit être récupérée à partir du champ « Operation-Location » retourné par l’interface de lecture.

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

Paramètres

operation_id

str

Obligatoire

ID de l’opération de lecture retournée dans la réponse de l’interface « Read ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

ReadOperationResult ou ClientRawResponse si raw=true

Type de retour

ReadOperationResult,

ClientRawResponse

Exceptions

ComputerVisionOcrErrorException

list_models

Cette opération renvoie la liste des modèles propres à un domaine qui sont pris en charge par l’API Vision par ordinateur. Actuellement, l’API prend en charge les modèles propres au domaine suivants : module de reconnaissance de célébrités, module de reconnaissance d’éléments géographiques. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

ListModelsResult ou ClientRawResponse si raw=true

Type de retour

ListModelsResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

read

Utilisez cette interface pour obtenir le résultat d’une opération de lecture, en utilisant les algorithmes de reconnaissance optique de caractères (OCR) de pointe optimisés pour les documents volumineux. Lorsque vous utilisez l’interface Read, la réponse contient un champ appelé « Operation-Location ». Le champ « Operation-Location » contient l’URL que vous devez utiliser pour votre opération « GetReadResult » afin d’accéder aux résultats de l’OCR..

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

Paramètres

url

str

Obligatoire

URL accessible publiquement d’une image.

language

str ou OcrDetectionLanguage

valeur par défaut: None

Code de langue BCP-47 du texte du document. Read prend en charge l’identification automatique de la langue et les documents multilingues. Par conséquent, fournissez un code de langue uniquement si vous souhaitez forcer le traitement du document dans cette langue spécifique. Consultez https://aka.ms/ocr-languages la liste des langues prises en charge. Les valeurs possibles sont les suivantes : '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]

valeur par défaut: None

Numéros de page personnalisés pour les documents multipage (PDF/TIFF), entrez le nombre de pages que vous souhaitez obtenir le résultat ocr. Pour une plage de pages, utilisez un trait d’union. Séparez chaque page ou plage par une virgule.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle OCR utilisé pour l’extraction de texte. Les valeurs acceptées sont les suivantes : « latest », « latest-preview », « 2021-04-12 ». La valeur par défaut est « latest ».

reading_order

str

valeur par défaut: basic

Paramètre facultatif pour spécifier l’algorithme d’ordre de lecture à appliquer lors du classement des éléments de texte d’extraction. Peut être « de base » ou « naturel ». La valeur par défaut est « de base » si elle n’est pas spécifiée

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

None ou ClientRawResponse si raw=true

Type de retour

None,

ClientRawResponse

Exceptions

ComputerVisionOcrErrorException

read_in_stream

Utilisez cette interface pour obtenir le résultat d’une opération de lecture, en utilisant les algorithmes de reconnaissance optique de caractères (OCR) de pointe optimisés pour les documents volumineux. Lorsque vous utilisez l’interface Read, la réponse contient un champ appelé « Operation-Location ». Le champ « Operation-Location » contient l’URL que vous devez utiliser pour votre opération « GetReadResult » afin d’accéder aux résultats de l’OCR..

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

Paramètres

image

Generator

Obligatoire

Flux d’images.

language

str ou OcrDetectionLanguage

valeur par défaut: None

Code de langue BCP-47 du texte du document. Read prend en charge l’identification automatique de la langue et les documents multilingues. Par conséquent, fournissez un code de langue uniquement si vous souhaitez forcer le traitement du document dans cette langue spécifique. Consultez https://aka.ms/ocr-languages la liste des langues prises en charge. Les valeurs possibles sont les suivantes : '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]

valeur par défaut: None

Numéros de page personnalisés pour les documents multipage (PDF/TIFF), entrez le nombre de pages que vous souhaitez obtenir le résultat ocr. Pour une plage de pages, utilisez un trait d’union. Séparez chaque page ou plage par une virgule.

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle OCR utilisé pour l’extraction de texte. Les valeurs acceptées sont les suivantes : « latest », « latest-preview », « 2021-04-12 ». La valeur par défaut est « latest ».

reading_order

str

valeur par défaut: basic

Paramètre facultatif pour spécifier l’algorithme d’ordre de lecture à appliquer lors du classement des éléments de texte d’extraction. Peut être « de base » ou « naturel ». La valeur par défaut est « de base » si elle n’est pas spécifiée

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

None ou ClientRawResponse si raw=true

Type de retour

None,

ClientRawResponse

Exceptions

ComputerVisionOcrErrorException

recognize_printed_text

Avec la reconnaissance optique de caractères (OCR), détectez du texte dans une image et extrayez les caractères reconnus dans un flux de caractères exploitable automatiquement. En cas de réussite, les résultats de l’OCR sont retournés. En cas d’échec, le code d’erreur ainsi qu’un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedImage, NotSupportedLanguage ou InternalServerError.

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

Paramètres

detect_orientation

bool

valeur par défaut: True

Détecter l’orientation du texte dans l’image. Avec detectOrientation=true, le service OCR tente de détecter l’orientation de l’image et de la corriger avant un traitement ultérieur (par exemple, si elle est à l’envers).

url

str

Obligatoire

URL accessible publiquement d’une image.

language

str ou OcrLanguages

valeur par défaut: unk

Code de langue BCP-47 du texte à détecter dans l’image. La valeur par défaut est 'unk'. Les valeurs possibles sont les suivantes : '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

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

OcrResult ou ClientRawResponse si raw=true

Type de retour

OcrResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

recognize_printed_text_in_stream

Avec la reconnaissance optique de caractères (OCR), détectez du texte dans une image et extrayez les caractères reconnus dans un flux de caractères exploitable automatiquement. En cas de réussite, les résultats de l’OCR sont retournés. En cas d’échec, le code d’erreur ainsi qu’un message d’erreur sont retournés. Le code d’erreur peut être invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedImage, NotSupportedLanguage ou InternalServerError.

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

Paramètres

detect_orientation

bool

valeur par défaut: True

Détecter l’orientation du texte dans l’image. Avec detectOrientation=true, le service OCR tente de détecter l’orientation de l’image et de la corriger avant un traitement ultérieur (par exemple, si elle est à l’envers).

image

Generator

Obligatoire

Flux d’images.

language

str ou OcrLanguages

valeur par défaut: unk

Code de langue BCP-47 du texte à détecter dans l’image. La valeur par défaut est 'unk'. Les valeurs possibles sont les suivantes : '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

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

OcrResult ou ClientRawResponse si raw=true

Type de retour

OcrResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

tag_image

Cette opération génère une liste de mots, ou balises, qui sont pertinents pour le contenu de l’image fournie. L’API Vision par ordinateur peut retourner des balises basées sur les objets, les êtres vivants, les paysages ou les actions trouvées dans les images. Contrairement aux catégories, les balises ne sont pas organisées selon un système de classification hiérarchique, mais correspondent au contenu de l’image. Les étiquettes peuvent contenir des indices pour éviter toute ambiguïté ou fournir un contexte, par exemple l'étiquette "ascomycète" peut être accompagnée de l'indice "fungus". Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

url

str

Obligatoire

URL accessible publiquement d’une image.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - Anglais, Par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles sont les suivantes : 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

TagResult ou ClientRawResponse si raw=true

Type de retour

TagResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException

tag_image_in_stream

Cette opération génère une liste de mots, ou balises, qui sont pertinents pour le contenu de l’image fournie. L’API Vision par ordinateur peut retourner des balises basées sur les objets, les êtres vivants, les paysages ou les actions trouvées dans les images. Contrairement aux catégories, les balises ne sont pas organisées selon un système de classification hiérarchique, mais correspondent au contenu de l’image. Les étiquettes peuvent contenir des indices pour éviter toute ambiguïté ou fournir un contexte, par exemple l'étiquette "ascomycète" peut être accompagnée de l'indice "fungus". Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Paramètres

image

Generator

Obligatoire

Flux d’images.

language

str

valeur par défaut: en

Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Langues prises en charge :en - Anglais, Par défaut. es - Espagnol, ja - Japonais, pt - Portugais, zh - Chinois simplifié. Les valeurs possibles sont les suivantes : 'en', 'es', 'ja', 'pt', 'zh'

model_version

str

valeur par défaut: latest

Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont : « latest », « 2021-04-01 ». La valeur par défaut est « latest ».

custom_headers

dict

valeur par défaut: None

en-têtes qui seront ajoutés à la demande

raw

bool

valeur par défaut: False

retourne la réponse directe en même temps que la réponse désérialisée

callback

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

valeur par défaut: None

Quand il est spécifié, est appelé avec chaque bloc de données qui est diffusé en continu. Le rappel doit prendre deux arguments, les octets du bloc de données actuel et l’objet de réponse. Si les données sont en cours de chargement, la réponse est None.

operation_config

Obligatoire

Remplacements de configuration d’opération.

Retours

TagResult ou ClientRawResponse si raw=true

Type de retour

TagResult,

ClientRawResponse

Exceptions

ComputerVisionErrorResponseException