Partager via


ComputerVisionClientOperationsMixin Classe

Héritage
builtins.object
ComputerVisionClientOperationsMixin

Constructeur

ComputerVisionClientOperationsMixin()

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, 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é.

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 les résultats des modèles de domaine de célébrités et de points de repère, 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 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é.

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 les résultats des modèles de domaine de célébrités et de points de repère, 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 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é.

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 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é.

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 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é.

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 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

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

Exceptions

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

Exceptions

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

Exceptions

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, 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_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 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

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

ImageAnalysis ou ClientRawResponse si raw=true

Type de retour

Exceptions

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 les résultats des modèles de domaine de célébrités et de points de repère, 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 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é.

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 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

ImageDescription ou ClientRawResponse si raw=true

Type de retour

Exceptions

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 les résultats des modèles de domaine de célébrités et de points de repère, 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 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é.

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 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

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

ImageDescription ou ClientRawResponse si raw=true

Type de retour

Exceptions

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 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é.

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 à côté de la réponse désérialisée

operation_config
Obligatoire

La configuration de l’opération remplace.

Retours

DetectResult ou ClientRawResponse si raw=true

Type de retour

Exceptions

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 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é.

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 à 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

DetectResult ou ClientRawResponse si raw=true

Type de retour

Exceptions

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

Exceptions

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

Exceptions

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

Exceptions

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

Exceptions

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

Exceptions

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

Exceptions

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,

Exceptions

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,

Exceptions

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

Exceptions

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

Exceptions

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

Exceptions

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 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é.

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 à 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

TagResult ou ClientRawResponse si raw=true

Type de retour

Exceptions