ComputerVisionClient Classe
A API de Imagem Digitalizada fornece algoritmos de última geração para processar imagens e devolver informações. Por exemplo, pode ser utilizado para determinar se uma imagem contém conteúdo maduro ou se pode ser utilizada para encontrar todos os rostos numa imagem. Tem também outras funcionalidades, como estimar a cor dominante e a cor de destaque, categorizar o conteúdo das imagens e descrever uma imagem com frases completas em português. Além disso, também consegue gerar miniaturas de imagens de forma inteligente para apresentar imagens grandes de forma eficaz.
- Herança
-
azure.cognitiveservices.vision.computervision.operations._computer_vision_client_operations.ComputerVisionClientOperationsMixinComputerVisionClientComputerVisionClient
Construtor
ComputerVisionClient(endpoint, credentials)
Parâmetros
- credentials
- None
Credenciais de subscrição que identificam exclusivamente a subscrição do cliente.
Variáveis
Configuração do cliente.
Métodos
analyze_image |
Esta operação extrai um conjunto avançado de funcionalidades visuais com base no conteúdo da imagem. São suportados dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar um URL de imagem. No seu pedido, existe um parâmetro opcional que lhe permite escolher as funcionalidades a devolver. Por predefinição, as categorias de imagem são devolvidas na resposta. Será devolvida uma resposta bem-sucedida no JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
analyze_image_by_domain |
Esta operação reconhece conteúdo numa imagem ao aplicar um modelo específico do domínio. A lista de modelos específicos de domínio suportados pela API Imagem Digitalizada pode ser obtida com o pedido GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, marcos. São suportados dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta bem-sucedida no JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
analyze_image_by_domain_in_stream |
Esta operação reconhece conteúdo numa imagem ao aplicar um modelo específico do domínio. A lista de modelos específicos de domínio suportados pela API Imagem Digitalizada pode ser obtida com o pedido GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, marcos. São suportados dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta bem-sucedida no JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
analyze_image_in_stream |
Esta operação extrai um conjunto avançado de funcionalidades visuais com base no conteúdo da imagem. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. No seu pedido, existe um parâmetro opcional que lhe permite escolher as funcionalidades a devolver. Por predefinição, as categorias de imagens são devolvidas na resposta. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
close |
Feche o cliente se keep_alive for Verdadeiro. |
describe_image |
Esta operação gera uma descrição de uma imagem em linguagem legível por humanos com frases completas. A descrição baseia-se numa coleção de etiquetas de conteúdo, que também são devolvidas pela operação. Pode ser gerada mais do que uma descrição para cada imagem. As descrições são ordenadas pela respetiva classificação de confiança. As descrições podem incluir resultados de modelos de domínio de referência e celebridades, se aplicável. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
describe_image_in_stream |
Esta operação gera uma descrição de uma imagem em linguagem legível por humanos com frases completas. A descrição baseia-se numa coleção de etiquetas de conteúdo, que também são devolvidas pela operação. Pode ser gerada mais do que uma descrição para cada imagem. As descrições são ordenadas pela respetiva classificação de confiança. As descrições podem incluir resultados de modelos de domínio de referência e celebridades, se aplicável. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
detect_objects |
Efetua a deteção de objetos na imagem especificada. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
detect_objects_in_stream |
Efetua a deteção de objetos na imagem especificada. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
generate_thumbnail |
Esta operação gera uma imagem em miniatura com a largura e altura especificadas pelo utilizador. Por predefinição, o serviço analisa a imagem, identifica a região de interesse (ROI) e gera coordenadas de recorte inteligentes com base no ROI. O recorte inteligente ajuda quando especifica uma proporção diferente da da imagem de entrada. Uma resposta com êxito contém o binário da imagem em miniatura. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
generate_thumbnail_in_stream |
Esta operação gera uma imagem em miniatura com a largura e altura especificadas pelo utilizador. Por predefinição, o serviço analisa a imagem, identifica a região de interesse (ROI) e gera coordenadas de recorte inteligentes com base no ROI. O recorte inteligente ajuda quando especifica uma proporção diferente da da imagem de entrada. Uma resposta com êxito contém o binário da imagem em miniatura. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
get_area_of_interest |
Esta operação devolve uma caixa delimitadora à volta da área mais importante da imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
get_area_of_interest_in_stream |
Esta operação devolve uma caixa delimitadora à volta da área mais importante da imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
get_read_result |
Esta interface é utilizada para obter resultados OCR da operação de Leitura. O URL para esta interface deve ser obtido a partir do campo "Operation-Location" devolvido da interface de Leitura. |
list_models |
Esta operação devolve a lista de modelos específicos do domínio suportados pela API Imagem Digitalizada. Atualmente, a API suporta os seguintes modelos específicos de domínio: reconhecedor de celebridades, reconhecedor de marcos. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
read |
Utilize esta interface para obter o resultado de uma operação de Leitura, ao utilizar os algoritmos OCR (Optical Character Recognition) de última geração otimizados para documentos pesados de texto. Quando utiliza a interface de Leitura, a resposta contém um campo chamado "Operation-Location". O campo "Operation-Location" contém o URL que tem de utilizar para a operação "GetReadResult" para aceder aos resultados do OCR.. |
read_in_stream |
Utilize esta interface para obter o resultado de uma operação de Leitura, ao utilizar os algoritmos OCR (Optical Character Recognition) de última geração otimizados para documentos pesados de texto. Quando utiliza a interface de Leitura, a resposta contém um campo chamado "Operation-Location". O campo "Operation-Location" contém o URL que tem de utilizar para a operação "GetReadResult" para aceder aos resultados do OCR.. |
recognize_printed_text |
O Reconhecimento Ótico de Carateres (OCR) deteta texto numa imagem e extrai os carateres reconhecidos para um fluxo de carateres utilizável por computador. Após o êxito, os resultados do OCR serão devolvidos. Após a falha, será devolvido o código de erro juntamente com uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage ou InternalServerError. |
recognize_printed_text_in_stream |
O Reconhecimento Ótico de Carateres (OCR) deteta texto numa imagem e extrai os carateres reconhecidos para um fluxo de carateres utilizável por computador. Após o êxito, os resultados do OCR serão devolvidos. Após a falha, será devolvido o código de erro juntamente com uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage ou InternalServerError. |
tag_image |
Esta operação gera uma lista de palavras ou etiquetas que são relevantes para o conteúdo da imagem fornecida. A API Imagem Digitalizada pode devolver etiquetas com base em objetos, seres vivos, cenários ou ações encontradas em imagens. Ao contrário das categorias, as etiquetas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As etiquetas podem conter sugestões para evitar ambiguidades ou fornecer contexto. Por exemplo, a etiqueta "ascomycete" pode ser acompanhada pela sugestão "fungo". São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
tag_image_in_stream |
Esta operação gera uma lista de palavras ou etiquetas que são relevantes para o conteúdo da imagem fornecida. A API Imagem Digitalizada pode devolver etiquetas com base em objetos, seres vivos, cenários ou ações encontradas em imagens. Ao contrário das categorias, as etiquetas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As etiquetas podem conter sugestões para evitar ambiguidades ou fornecer contexto. Por exemplo, a etiqueta "ascomycete" pode ser acompanhada pela sugestão "fungo". São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal. |
analyze_image
Esta operação extrai um conjunto avançado de funcionalidades visuais com base no conteúdo da imagem. São suportados dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar um URL de imagem. No seu pedido, existe um parâmetro opcional que lhe permite escolher as funcionalidades a devolver. Por predefinição, as categorias de imagem são devolvidas na resposta. Será devolvida uma resposta bem-sucedida no JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
analyze_image(url, visual_features=None, details=None, language='en', description_exclude=None, model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- visual_features
- list[str ou VisualFeatureTypes]
Uma cadeia que indica os tipos de funcionalidades visuais a devolver. Vários valores devem estar separados por vírgulas. Os tipos de funcionalidades visuais válidos incluem: Categorias – categoriza o conteúdo da imagem de acordo com uma taxonomia definida na documentação. Etiquetas – identifica a imagem com uma lista detalhada de palavras relacionadas com o conteúdo da imagem. Descrição – descreve o conteúdo da imagem com uma frase completa em inglês. Rostos – deteta se os rostos estão presentes. Se estiver presente, gere coordenadas, sexo e idade. ImageType - deteta se a imagem é clipart ou um desenho de linha. Cor – determina a cor do destaque, a cor dominante e se uma imagem é branca a preto&. Adulto - deteta se a imagem é pornográfica por natureza (representa nudez ou um ato sexual), ou é sangrenta (representa violência extrema ou sangue). Também é detetado conteúdo sexualmente sugestivo (também conhecido como conteúdo picante). Objetos – deteta vários objetos numa imagem, incluindo a localização aproximada. O argumento Objetos só está disponível em inglês. Marcas – deteta várias marcas dentro de uma imagem, incluindo a localização aproximada. O argumento Marcas só está disponível em inglês.
Uma cadeia que indica os detalhes específicos do domínio a devolver. Vários valores devem estar separados por vírgulas. Os tipos de funcionalidades visuais válidos incluem: Celebridades - identifica celebridades se forem detetadas na imagem, Marcos - identificam marcos notáveis na imagem.
- language
- str
O idioma pretendido para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:pt - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- description_exclude
- list[str ou DescriptionExclude]
Desative os modelos de domínio especificados ao gerar a descrição.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- raw
- bool
devolve a resposta direta juntamente com a resposta desserializada
- operation_config
Substituições da configuração da operação.
Devoluções
ImageAnalysis ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
analyze_image_by_domain
Esta operação reconhece conteúdo numa imagem ao aplicar um modelo específico do domínio. A lista de modelos específicos de domínio suportados pela API Imagem Digitalizada pode ser obtida com o pedido GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, marcos. São suportados dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta bem-sucedida no JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
analyze_image_by_domain(model, url, language='en', model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- language
- str
O idioma pretendido para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:pt - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- raw
- bool
devolve a resposta direta juntamente com a resposta desserializada
- operation_config
Substituições da configuração da operação.
Devoluções
DomainModelResults ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
analyze_image_by_domain_in_stream
Esta operação reconhece conteúdo numa imagem ao aplicar um modelo específico do domínio. A lista de modelos específicos de domínio suportados pela API Imagem Digitalizada pode ser obtida com o pedido GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, marcos. São suportados dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta bem-sucedida no JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
analyze_image_by_domain_in_stream(model, image, language='en', model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)
Parâmetros
- language
- str
O idioma pretendido para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:pt - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- raw
- bool
devolve a resposta direta juntamente com a resposta desserializada
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos, os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
DomainModelResults ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
analyze_image_in_stream
Esta operação extrai um conjunto avançado de funcionalidades visuais com base no conteúdo da imagem. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. No seu pedido, existe um parâmetro opcional que lhe permite escolher as funcionalidades a devolver. Por predefinição, as categorias de imagens são devolvidas na resposta. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
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)
Parâmetros
- visual_features
- list[str ou VisualFeatureTypes]
Uma cadeia que indica os tipos de funcionalidades visuais a devolver. Vários valores devem estar separados por vírgulas. Os tipos de funcionalidades visuais válidos incluem: Categorias – categoriza o conteúdo da imagem de acordo com uma taxonomia definida na documentação. Etiquetas – identifica a imagem com uma lista detalhada de palavras relacionadas com o conteúdo da imagem. Descrição – descreve o conteúdo da imagem com uma frase completa em inglês. Rostos – deteta se os rostos estão presentes. Se estiver presente, gere coordenadas, género e idade. ImageType – deteta se a imagem é clipart ou um desenho de linha. Cor – determina a cor do ambiente, a cor dominante e se uma imagem é branca a preto&. Adulto - deteta se a imagem é pornográfica por natureza (representa nudez ou um ato sexual), ou é sangrento (retrata a violência extrema ou o sangue). Também é detetado conteúdo sexualmente sugestivo (também conhecido como conteúdo picante). Objetos – deteta vários objetos numa imagem, incluindo a localização aproximada. O argumento Objetos só está disponível em inglês. Marcas – deteta várias marcas numa imagem, incluindo a localização aproximada. O argumento Marcas só está disponível em inglês.
Uma cadeia que indica os detalhes específicos do domínio a devolver. Vários valores devem ser separados por vírgulas. Os tipos de funcionalidades visuais válidos incluem: Celebridades - identifica celebridades se forem detetadas na imagem, Marcos - identifica marcos notáveis na imagem.
- language
- str
A linguagem pretendida para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:en - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- description_exclude
- list[str ou DescriptionExclude]
Desative os modelos de domínio especificados ao gerar a descrição.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
ImageAnalysis ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
close
Feche o cliente se keep_alive for Verdadeiro.
close() -> None
Exceções
describe_image
Esta operação gera uma descrição de uma imagem em linguagem legível por humanos com frases completas. A descrição baseia-se numa coleção de etiquetas de conteúdo, que também são devolvidas pela operação. Pode ser gerada mais do que uma descrição para cada imagem. As descrições são ordenadas pela respetiva classificação de confiança. As descrições podem incluir resultados de modelos de domínio de referência e celebridades, se aplicável. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
describe_image(url, max_candidates=1, language='en', description_exclude=None, model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- max_candidates
- int
Número máximo de descrições de candidatos a devolver. A predefinição é 1.
- language
- str
A linguagem pretendida para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:en - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- description_exclude
- list[str ou DescriptionExclude]
Desative os modelos de domínio especificados ao gerar a descrição.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- operation_config
Substituições da configuração da operação.
Devoluções
ImageDescription ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
describe_image_in_stream
Esta operação gera uma descrição de uma imagem em linguagem legível por humanos com frases completas. A descrição baseia-se numa coleção de etiquetas de conteúdo, que também são devolvidas pela operação. Pode ser gerada mais do que uma descrição para cada imagem. As descrições são ordenadas pela respetiva classificação de confiança. As descrições podem incluir resultados de modelos de domínio de referência e celebridades, se aplicável. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
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)
Parâmetros
- max_candidates
- int
Número máximo de descrições de candidatos a devolver. A predefinição é 1.
- language
- str
A linguagem pretendida para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:en - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- description_exclude
- list[str ou DescriptionExclude]
Desative os modelos de domínio especificados ao gerar a descrição.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
ImageDescription ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
detect_objects
Efetua a deteção de objetos na imagem especificada. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
detect_objects(url, model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- operation_config
Substituições da configuração da operação.
Devoluções
DetectResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
detect_objects_in_stream
Efetua a deteção de objetos na imagem especificada. São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
detect_objects_in_stream(image, model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)
Parâmetros
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
DetectResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
generate_thumbnail
Esta operação gera uma imagem em miniatura com a largura e altura especificadas pelo utilizador. Por predefinição, o serviço analisa a imagem, identifica a região de interesse (ROI) e gera coordenadas de recorte inteligentes com base no ROI. O recorte inteligente ajuda quando especifica uma proporção diferente da da imagem de entrada. Uma resposta com êxito contém o binário da imagem em miniatura. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser 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)
Parâmetros
- width
- int
Largura da miniatura, em píxeis. Tem de estar entre 1 e 1024. Recomendado mínimo de 50.
- height
- int
Altura da miniatura, em píxeis. Tem de estar entre 1 e 1024. Recomendado mínimo de 50.
- smart_cropping
- bool
Sinalizador booleano para ativar o recorte inteligente.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
objeto ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
generate_thumbnail_in_stream
Esta operação gera uma imagem em miniatura com a largura e altura especificadas pelo utilizador. Por predefinição, o serviço analisa a imagem, identifica a região de interesse (ROI) e gera coordenadas de recorte inteligentes com base no ROI. O recorte inteligente ajuda quando especifica uma proporção diferente da da imagem de entrada. Uma resposta com êxito contém o binário da imagem em miniatura. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser 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)
Parâmetros
- width
- int
Largura da miniatura, em píxeis. Tem de estar entre 1 e 1024. Recomendado mínimo de 50.
- height
- int
Altura da miniatura, em píxeis. Tem de estar entre 1 e 1024. Recomendado mínimo de 50.
- smart_cropping
- bool
Sinalizador booleano para ativar o recorte inteligente.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
objeto ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_area_of_interest
Esta operação devolve uma caixa delimitadora à volta da área mais importante da imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.
get_area_of_interest(url, model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- operation_config
Substituições da configuração da operação.
Devoluções
AreaOfInterestResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_area_of_interest_in_stream
Esta operação devolve uma caixa delimitadora à volta da área mais importante da imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta contém um código de erro e uma mensagem para ajudar a determinar o que correu mal. Após a falha, é devolvido o código de erro e uma mensagem de erro. O código de erro pode ser 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)
Parâmetros
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
AreaOfInterestResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_read_result
Esta interface é utilizada para obter resultados OCR da operação de Leitura. O URL para esta interface deve ser obtido a partir do campo "Operation-Location" devolvido da interface de Leitura.
get_read_result(operation_id, custom_headers=None, raw=False, **operation_config)
Parâmetros
- operation_config
Substituições da configuração da operação.
Devoluções
ReadOperationResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
list_models
Esta operação devolve a lista de modelos específicos do domínio suportados pela API Imagem Digitalizada. Atualmente, a API suporta os seguintes modelos específicos de domínio: reconhecedor de celebridades, reconhecedor de marcos. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
list_models(custom_headers=None, raw=False, **operation_config)
Parâmetros
- operation_config
Substituições da configuração da operação.
Devoluções
ListModelsResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
read
Utilize esta interface para obter o resultado de uma operação de Leitura, ao utilizar os algoritmos OCR (Optical Character Recognition) de última geração otimizados para documentos pesados de texto. Quando utiliza a interface de Leitura, a resposta contém um campo chamado "Operation-Location". O campo "Operation-Location" contém o URL que tem de utilizar para a operação "GetReadResult" para aceder aos resultados do OCR..
read(url, language=None, pages=None, model_version='latest', reading_order='basic', custom_headers=None, raw=False, **operation_config)
Parâmetros
- language
- str ou OcrDetectionLanguage
O código de idioma BCP-47 do texto no documento. A funcionalidade Ler suporta a identificação automática de idiomas e documentos de vários idiomas, pelo que só fornece um código de idioma se pretender forçar o processamento do documento nesse idioma específico. Veja https://aka.ms/ocr-languages para obter uma lista de idiomas suportados. Os valores possíveis incluem: "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', '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'
Números de página personalizados para documentos de várias páginas (PDF/TIFF), introduza o número de páginas que pretende obter o resultado do OCR. Para um intervalo de páginas, utilize um hífen. Separe cada página ou intervalo com uma vírgula.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo OCR utilizado para extração de texto. Os valores aceites são: "latest", "latest-preview", "2021-04-12". A predefinição é "mais recente".
- reading_order
- str
Parâmetro opcional para especificar que algoritmo de ordem de leitura deve ser aplicado ao ordenar os elementos de texto de extração. Pode ser "básico" ou "natural". A predefinição será "básica" se não for especificada
- operation_config
Substituições da configuração da operação.
Devoluções
Nenhum ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
read_in_stream
Utilize esta interface para obter o resultado de uma operação de Leitura, ao utilizar os algoritmos OCR (Optical Character Recognition) de última geração otimizados para documentos pesados de texto. Quando utiliza a interface de Leitura, a resposta contém um campo chamado "Operation-Location". O campo "Operation-Location" contém o URL que tem de utilizar para a operação "GetReadResult" para aceder aos resultados do OCR..
read_in_stream(image, language=None, pages=None, model_version='latest', reading_order='basic', custom_headers=None, raw=False, callback=None, **operation_config)
Parâmetros
- language
- str ou OcrDetectionLanguage
O código de idioma BCP-47 do texto no documento. A funcionalidade Ler suporta a identificação automática de idiomas e documentos de vários idiomas, pelo que só fornece um código de idioma se pretender forçar o processamento do documento nesse idioma específico. Veja https://aka.ms/ocr-languages para obter uma lista de idiomas suportados. Os valores possíveis incluem: "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', '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'
Números de página personalizados para documentos de várias páginas (PDF/TIFF), introduza o número de páginas que pretende obter o resultado do OCR. Para um intervalo de páginas, utilize um hífen. Separe cada página ou intervalo com uma vírgula.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo OCR utilizado para extração de texto. Os valores aceites são: "latest", "latest-preview", "2021-04-12". A predefinição é "mais recente".
- reading_order
- str
Parâmetro opcional para especificar que algoritmo de ordem de leitura deve ser aplicado ao ordenar os elementos de texto de extração. Pode ser "básico" ou "natural". A predefinição será "básica" se não for especificada
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
Nenhum ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
recognize_printed_text
O Reconhecimento Ótico de Carateres (OCR) deteta texto numa imagem e extrai os carateres reconhecidos para um fluxo de carateres utilizável por computador. Após o êxito, os resultados do OCR serão devolvidos. Após a falha, será devolvido o código de erro juntamente com uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage ou InternalServerError.
recognize_printed_text(url, detect_orientation=True, language='unk', model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- detect_orientation
- bool
Se detetar a orientação do texto na imagem. Com detectOrientation=true, o serviço OCR tenta detetar a orientação da imagem e corrigi-la antes de continuar o processamento (por exemplo, se estiver ao contrário).
- language
- str ou OcrLanguages
O código de idioma BCP-47 do texto a ser detetado na imagem. O valor predefinido é "unk". Os valores possíveis incluem: "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
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- operation_config
Substituições da configuração da operação.
Devoluções
OcrResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
recognize_printed_text_in_stream
O Reconhecimento Ótico de Carateres (OCR) deteta texto numa imagem e extrai os carateres reconhecidos para um fluxo de carateres utilizável por computador. Após o êxito, os resultados do OCR serão devolvidos. Após a falha, será devolvido o código de erro juntamente com uma mensagem de erro. O código de erro pode ser invalidImageUrl, InvalidImageFormat, InvalidImageSize, 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)
Parâmetros
- detect_orientation
- bool
Se detetar a orientação do texto na imagem. Com detectOrientation=true, o serviço OCR tenta detetar a orientação da imagem e corrigi-la antes de continuar o processamento (por exemplo, se estiver ao contrário).
- language
- str ou OcrLanguages
O código de idioma BCP-47 do texto a ser detetado na imagem. O valor predefinido é "unk". Os valores possíveis incluem: "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
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
OcrResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
tag_image
Esta operação gera uma lista de palavras ou etiquetas que são relevantes para o conteúdo da imagem fornecida. A API Imagem Digitalizada pode devolver etiquetas com base em objetos, seres vivos, cenários ou ações encontradas em imagens. Ao contrário das categorias, as etiquetas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As etiquetas podem conter sugestões para evitar ambiguidades ou fornecer contexto. Por exemplo, a etiqueta "ascomycete" pode ser acompanhada pela sugestão "fungo". São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
tag_image(url, language='en', model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- language
- str
A linguagem pretendida para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:en - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- operation_config
Substituições da configuração da operação.
Devoluções
TagResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
tag_image_in_stream
Esta operação gera uma lista de palavras ou etiquetas que são relevantes para o conteúdo da imagem fornecida. A API Imagem Digitalizada pode devolver etiquetas com base em objetos, seres vivos, cenários ou ações encontradas em imagens. Ao contrário das categorias, as etiquetas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As etiquetas podem conter sugestões para evitar ambiguidades ou fornecer contexto. Por exemplo, a etiqueta "ascomycete" pode ser acompanhada pela sugestão "fungo". São suportados dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar um URL de imagem. Será devolvida uma resposta com êxito em JSON. Se o pedido falhar, a resposta conterá um código de erro e uma mensagem para ajudar a compreender o que correu mal.
tag_image_in_stream(image, language='en', model_version='latest', custom_headers=None, raw=False, callback=None, **operation_config)
Parâmetros
- language
- str
A linguagem pretendida para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Idiomas suportados:en - Inglês, Predefinição. es - espanhol, ja - japonês, pt - português, zh - chinês simplificado. Os valores possíveis incluem: "en", "es", "ja", "pt", "zh"
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01". A predefinição é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
TagResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
Azure SDK for Python