ComputerVisionClientOperationsMixin Classe
- Herança
-
builtins.objectComputerVisionClientOperationsMixin
Construtor
ComputerVisionClientOperationsMixin()
Métodos
analyze_image |
Essa operação extrai um conjunto avançado de recursos visuais com base no conteúdo da imagem. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Em sua solicitação, há um parâmetro opcional para permitir que você escolha quais recursos retornar. Por padrão, as categorias de imagem são retornadas na resposta. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
analyze_image_by_domain |
Essa operação reconhece o conteúdo em uma imagem aplicando um modelo específico de domínio. A lista de modelos específicos de domínio com suporte pelo API da Pesquisa Visual Computacional pode ser recuperada usando a solicitação GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, pontos de referência. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
analyze_image_by_domain_in_stream |
Essa operação reconhece o conteúdo em uma imagem aplicando um modelo específico de domínio. A lista de modelos específicos de domínio com suporte pelo API da Pesquisa Visual Computacional pode ser recuperada usando a solicitação GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, pontos de referência. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
analyze_image_in_stream |
Essa operação extrai um conjunto avançado de recursos visuais com base no conteúdo da imagem. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Em sua solicitação, há um parâmetro opcional para permitir que você escolha quais recursos retornar. Por padrão, as categorias de imagem são retornadas na resposta. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
describe_image |
Esta operação gera uma descrição de uma imagem no idioma legível por humanos com frases completas. A descrição se baseia em uma coleção de marcas de conteúdo, que também são retornadas pela operação. Mais de uma descrição pode ser gerada para cada imagem. As descrições são ordenadas por pontuação de confiança. As descrições podem incluir resultados de modelos de domínio de celebridades e de referência, se aplicável. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
describe_image_in_stream |
Esta operação gera uma descrição de uma imagem no idioma legível por humanos com frases completas. A descrição se baseia em uma coleção de marcas de conteúdo, que também são retornadas pela operação. Mais de uma descrição pode ser gerada para cada imagem. As descrições são ordenadas por pontuação de confiança. As descrições podem incluir resultados de modelos de domínio de celebridades e de referência, se aplicável. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
detect_objects |
Executa a detecção de objetos na imagem especificada. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
detect_objects_in_stream |
Executa a detecção de objetos na imagem especificada. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
generate_thumbnail |
Essa operação gera uma imagem em miniatura com a altura e a largura especificadas pelo usuário. Por padrão, o serviço analisa a imagem, identifica a ROI (região de interesse) e gera as coordenadas de corte inteligentes com base no ROI. O corte inteligente ajuda quando você especifica uma taxa de proporção diferente da da imagem de entrada. Uma resposta bem-sucedida contém o binário da imagem em miniatura. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
generate_thumbnail_in_stream |
Essa operação gera uma imagem em miniatura com a altura e a largura especificadas pelo usuário. Por padrão, o serviço analisa a imagem, identifica a ROI (região de interesse) e gera as coordenadas de corte inteligentes com base no ROI. O corte inteligente ajuda quando você especifica uma taxa de proporção diferente da da imagem de entrada. Uma resposta bem-sucedida contém o binário da imagem em miniatura. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
get_area_of_interest |
Essa operação retorna uma caixa delimitadora em torno da área mais importante da imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
get_area_of_interest_in_stream |
Essa operação retorna uma caixa delimitadora em torno da área mais importante da imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError. |
get_read_result |
Essa interface é usada para obter os resultados de OCR da operação de leitura. A URL para essa interface deve ser recuperada do campo 'Operation-Location' retornado da interface De leitura. |
list_models |
Essa operação retorna a lista de modelos específicos de domínio com suporte pela API de Pesquisa Visual Computacional. Atualmente, a API dá suporte aos seguintes modelos específicos de domínio: reconhecedor de celebridades, reconhecedor de pontos de referência. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
read |
Use essa interface para obter o resultado de uma operação de leitura, empregando os algoritmos OCR (Reconhecimento Óptico de Caracteres) de última geração otimizados para documentos com texto pesado. Quando você usa a interface De leitura, a resposta contém um campo chamado 'Operation-Location'. O campo 'Operation-Location' contém a URL que você deve usar para sua operação 'GetReadResult' para acessar os resultados do OCR.. |
read_in_stream |
Use essa interface para obter o resultado de uma operação de leitura, empregando os algoritmos OCR (Reconhecimento Óptico de Caracteres) de última geração otimizados para documentos com texto pesado. Quando você usa a interface De leitura, a resposta contém um campo chamado 'Operation-Location'. O campo 'Operation-Location' contém a URL que você deve usar para sua operação 'GetReadResult' para acessar os resultados do OCR.. |
recognize_printed_text |
O OCR (reconhecimento óptico de caracteres) detecta o texto em uma imagem e extrai os caracteres reconhecidos para um fluxo de caracteres utilizável por computador. Após o sucesso, os resultados do OCR serão retornados. Após a falha, o código de erro junto com uma mensagem de erro será retornado. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage ou InternalServerError. |
recognize_printed_text_in_stream |
O OCR (reconhecimento óptico de caracteres) detecta o texto em uma imagem e extrai os caracteres reconhecidos para um fluxo de caracteres utilizável por computador. Após o sucesso, os resultados do OCR serão retornados. Após a falha, o código de erro junto com uma mensagem de erro será retornado. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, NotSupportedLanguage ou InternalServerError. |
tag_image |
Esta operação gera uma lista de palavras ou marcas que são relevantes para o conteúdo da imagem fornecida. A API da Pesquisa Visual Computacional pode retornar marcas com base em objetos, seres vivos, cenário ou ações encontradas em imagens. Diferentemente das categorias, as marcas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As marcas podem conter dicas para evitar ambiguidade ou dar contexto, por exemplo, a marca "ascomycota" pode ser acompanhada pela dica "fungo". Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
tag_image_in_stream |
Esta operação gera uma lista de palavras ou marcas que são relevantes para o conteúdo da imagem fornecida. A API da Pesquisa Visual Computacional pode retornar marcas com base em objetos, seres vivos, cenário ou ações encontradas em imagens. Diferentemente das categorias, as marcas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As marcas podem conter dicas para evitar ambiguidade ou dar contexto, por exemplo, a marca "ascomycota" pode ser acompanhada pela dica "fungo". Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado. |
analyze_image
Essa operação extrai um conjunto avançado de recursos visuais com base no conteúdo da imagem. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Em sua solicitação, há um parâmetro opcional para permitir que você escolha quais recursos retornar. Por padrão, as categorias de imagem são retornadas na resposta. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 de caracteres que indica quais tipos de recursos visuais devem ser retornados. Vários valores devem ser separados por vírgulas. Os tipos de recursos visuais válidos incluem: Categorias – categoriza o conteúdo da imagem de acordo com uma taxonomia definida na documentação. Marcas – marca a imagem com uma lista detalhada de palavras relacionadas ao conteúdo da imagem. Descrição - descreve o conteúdo da imagem com uma frase em inglês completa. Faces – detecta se os rostos estão presentes. Se encontrar, gera coordenadas, sexo e idade. ImageType - detecta se a imagem é clip-art ou um desenho de linha. Cor – determina a cor de destaque, a cor dominante e se uma imagem é branca em preto&. Adulto - detecta se a imagem é pornográfica por natureza (retrata nudez ou um ato sexual) ou é sangrenta (retrata violência extrema ou sangue). Conteúdo sexual (também conhecido como conteúdo picante) também será detectado. Objetos – detecta vários objetos dentro de uma imagem, incluindo o local aproximado. O argumento Objects só está disponível em inglês. Marcas – detecta várias marcas dentro de uma imagem, incluindo a localização aproximada. O argumento Brands só está disponível em inglês.
Uma cadeia de caracteres que indica quais detalhes específicos do domínio devem ser retornados. Vários valores devem ser separados por vírgulas. Os tipos de recursos visuais válidos incluem: Celebridades - identifica celebridades se detectadas na imagem, Landmarks - identifica pontos de referência notáveis na imagem.
- language
- str
A linguagem desejada para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
ImageAnalysis ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
analyze_image_by_domain
Essa operação reconhece o conteúdo em uma imagem aplicando um modelo específico de domínio. A lista de modelos específicos de domínio com suporte pelo API da Pesquisa Visual Computacional pode ser recuperada usando a solicitação GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, pontos de referência. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
analyze_image_by_domain(model, url, language='en', model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- language
- str
A linguagem desejada para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
DomainModelResults ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
analyze_image_by_domain_in_stream
Essa operação reconhece o conteúdo em uma imagem aplicando um modelo específico de domínio. A lista de modelos específicos de domínio com suporte pelo API da Pesquisa Visual Computacional pode ser recuperada usando a solicitação GET /models. Atualmente, a API fornece os seguintes modelos específicos de domínio: celebridades, pontos de referência. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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
A linguagem desejada para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve receber dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem sendo carregados, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
DomainModelResults ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
analyze_image_in_stream
Essa operação extrai um conjunto avançado de recursos visuais com base no conteúdo da imagem. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Em sua solicitação, há um parâmetro opcional para permitir que você escolha quais recursos retornar. Por padrão, as categorias de imagem são retornadas na resposta. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 de caracteres que indica quais tipos de recursos visuais devem ser retornados. Vários valores devem ser separados por vírgulas. Os tipos de recursos visuais válidos incluem: Categorias – categoriza o conteúdo da imagem de acordo com uma taxonomia definida na documentação. Marcas – marca a imagem com uma lista detalhada de palavras relacionadas ao conteúdo da imagem. Descrição - descreve o conteúdo da imagem com uma frase em inglês completa. Faces – detecta se os rostos estão presentes. Se encontrar, gera coordenadas, sexo e idade. ImageType - detecta se a imagem é clip-art ou um desenho de linha. Cor – determina a cor de destaque, a cor dominante e se uma imagem é branca em preto&. Adulto - detecta se a imagem é pornográfica por natureza (retrata nudez ou um ato sexual) ou é sangrenta (retrata violência extrema ou sangue). Conteúdo sexual (também conhecido como conteúdo picante) também será detectado. Objetos – detecta vários objetos dentro de uma imagem, incluindo o local aproximado. O argumento Objects só está disponível em inglês. Marcas – detecta várias marcas dentro de uma imagem, incluindo a localização aproximada. O argumento Brands só está disponível em inglês.
Uma cadeia de caracteres que indica quais detalhes específicos do domínio devem ser retornados. Vários valores devem ser separados por vírgulas. Os tipos de recursos visuais válidos incluem: Celebridades - identifica celebridades se detectadas na imagem, Pontos de referência - identifica pontos de referência notáveis na imagem.
- language
- str
O idioma desejado para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve ter dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem carregando, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
ImageAnalysis ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
describe_image
Esta operação gera uma descrição de uma imagem no idioma legível por humanos com frases completas. A descrição se baseia em uma coleção de marcas de conteúdo, que também são retornadas pela operação. Mais de uma descrição pode ser gerada para cada imagem. As descrições são ordenadas por pontuação de confiança. As descrições podem incluir resultados de modelos de domínio de celebridades e de referência, se aplicável. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 serem retornadas. O padrão é 1.
- language
- str
O idioma desejado para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
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 no idioma legível por humanos com frases completas. A descrição se baseia em uma coleção de marcas de conteúdo, que também são retornadas pela operação. Mais de uma descrição pode ser gerada para cada imagem. As descrições são ordenadas por pontuação de confiança. As descrições podem incluir resultados de modelos de domínio de celebridades e de referência, se aplicável. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 serem retornadas. O padrão é 1.
- language
- str
O idioma desejado para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve ter dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem carregando, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
ImageDescription ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
detect_objects
Executa a detecção de objetos na imagem especificada. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
DetectResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
detect_objects_in_stream
Executa a detecção de objetos na imagem especificada. Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve ter dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem carregando, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
DetectResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
generate_thumbnail
Essa operação gera uma imagem em miniatura com a altura e a largura especificadas pelo usuário. Por padrão, o serviço analisa a imagem, identifica a ROI (região de interesse) e gera as coordenadas de corte inteligentes com base no ROI. O corte inteligente ajuda quando você especifica uma taxa de proporção diferente da da imagem de entrada. Uma resposta bem-sucedida contém o binário da imagem em miniatura. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de 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 pixels. Deve estar entre 1 e 1024. Mínimo recomendado de 50.
- height
- int
Altura da miniatura, em pixels. Deve estar entre 1 e 1024. Mínimo recomendado de 50.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve receber dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem sendo carregados, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
object ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
generate_thumbnail_in_stream
Essa operação gera uma imagem em miniatura com a altura e a largura especificadas pelo usuário. Por padrão, o serviço analisa a imagem, identifica a ROI (região de interesse) e gera as coordenadas de corte inteligentes com base no ROI. O corte inteligente ajuda quando você especifica uma taxa de proporção diferente da da imagem de entrada. Uma resposta bem-sucedida contém o binário da imagem em miniatura. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de 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 pixels. Deve estar entre 1 e 1024. Mínimo recomendado de 50.
- height
- int
Altura da miniatura, em pixels. Deve estar entre 1 e 1024. Mínimo recomendado de 50.
- model_version
- str
Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve receber dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem sendo carregados, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
object ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_area_of_interest
Essa operação retorna uma caixa delimitadora em torno da área mais importante da imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de 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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
AreaOfInterestResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_area_of_interest_in_stream
Essa operação retorna uma caixa delimitadora em torno da área mais importante da imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhou, a resposta conterá um código de erro e uma mensagem para ajudar a determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de 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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve receber dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem sendo carregados, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
AreaOfInterestResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_read_result
Essa interface é usada para obter os resultados de OCR da operação de leitura. A URL para essa interface deve ser recuperada do campo 'Operation-Location' retornado da interface De leitura.
get_read_result(operation_id, custom_headers=None, raw=False, **operation_config)
Parâmetros
- operation_config
Substituições de configuração de operação.
Retornos
ReadOperationResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
list_models
Essa operação retorna a lista de modelos específicos de domínio com suporte pela API de Pesquisa Visual Computacional. Atualmente, a API dá suporte aos seguintes modelos específicos de domínio: reconhecedor de celebridades, reconhecedor de pontos de referência. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
list_models(custom_headers=None, raw=False, **operation_config)
Parâmetros
- operation_config
Substituições de configuração de operação.
Retornos
ListModelsResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
read
Use essa interface para obter o resultado de uma operação de leitura, empregando os algoritmos OCR (Reconhecimento Óptico de Caracteres) de última geração otimizados para documentos com texto pesado. Quando você usa a interface De leitura, a resposta contém um campo chamado 'Operation-Location'. O campo 'Operation-Location' contém a URL que você deve usar para sua operação 'GetReadResult' para acessar os 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 linguagem BCP-47 do texto no documento. A leitura dá suporte à identificação automática de idioma e a documentos de vários idiomas, portanto, forneça apenas um código de idioma se você quiser forçar o documento a ser processado nesse idioma específico. Confira https://aka.ms/ocr-languages a lista de idiomas com suporte. 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', '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), insira o número das páginas que você deseja obter o resultado do OCR. Para um intervalo de páginas, use 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 usado para extração de texto. Os valores aceitos são: "latest", "latest-preview", "2021-04-12". O padrão é "mais recente".
- reading_order
- str
Parâmetro opcional para especificar qual algoritmo de ordem de leitura deve ser aplicado ao ordenar os elementos de texto de extração. Pode ser "básico" ou "natural". O padrão será 'básico' se não for especificado
- operation_config
Substituições de configuração de operação.
Retornos
None ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
read_in_stream
Use essa interface para obter o resultado de uma operação de leitura, empregando os algoritmos OCR (Reconhecimento Óptico de Caracteres) de última geração otimizados para documentos com texto pesado. Quando você usa a interface De leitura, a resposta contém um campo chamado 'Operation-Location'. O campo 'Operation-Location' contém a URL que você deve usar para sua operação 'GetReadResult' para acessar os 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 linguagem BCP-47 do texto no documento. A leitura dá suporte à identificação automática de idioma e a documentos de vários idiomas, portanto, forneça apenas um código de idioma se você quiser forçar o documento a ser processado nesse idioma específico. Confira https://aka.ms/ocr-languages a lista de idiomas com suporte. 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', '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), insira o número das páginas que você deseja obter o resultado do OCR. Para um intervalo de páginas, use 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 usado para extração de texto. Os valores aceitos são: "latest", "latest-preview", "2021-04-12". O padrão é "mais recente".
- reading_order
- str
Parâmetro opcional para especificar qual algoritmo de ordem de leitura deve ser aplicado ao ordenar os elementos de texto de extração. Pode ser "básico" ou "natural". O padrão será 'básico' se não for especificado
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve receber dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem sendo carregados, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
None ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
recognize_printed_text
O OCR (reconhecimento óptico de caracteres) detecta o texto em uma imagem e extrai os caracteres reconhecidos para um fluxo de caracteres utilizável por computador. Após o sucesso, os resultados do OCR serão retornados. Após a falha, o código de erro junto com uma mensagem de erro será retornado. O código de erro pode ser um de 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 detecta a orientação de texto na imagem. Com detectOrientation=true, o serviço OCR tenta detectar a orientação da imagem e corrigi-la antes de processamento adicional (por exemplo, se estiver de cabeça para baixo).
- language
- str ou OcrLanguages
O código de linguagem BCP-47 do texto a ser detectado na imagem. O valor padrão é '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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
OcrResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
recognize_printed_text_in_stream
O OCR (reconhecimento óptico de caracteres) detecta o texto em uma imagem e extrai os caracteres reconhecidos para um fluxo de caracteres utilizável por computador. Após o sucesso, os resultados do OCR serão retornados. Após a falha, o código de erro junto com uma mensagem de erro será retornado. O código de erro pode ser um de 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 detecta a orientação de texto na imagem. Com detectOrientation=true, o serviço OCR tenta detectar a orientação da imagem e corrigi-la antes de processamento adicional (por exemplo, se estiver de cabeça para baixo).
- language
- str ou OcrLanguages
O código de linguagem BCP-47 do texto a ser detectado na imagem. O valor padrão é '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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve receber dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem sendo carregados, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
OcrResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
tag_image
Esta operação gera uma lista de palavras ou marcas que são relevantes para o conteúdo da imagem fornecida. A API da Pesquisa Visual Computacional pode retornar marcas com base em objetos, seres vivos, cenário ou ações encontradas em imagens. Diferentemente das categorias, as marcas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As marcas podem conter dicas para evitar ambiguidade ou dar contexto, por exemplo, a marca "ascomycota" pode ser acompanhada pela dica "fungo". Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
tag_image(url, language='en', model_version='latest', custom_headers=None, raw=False, **operation_config)
Parâmetros
- language
- str
A linguagem desejada para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- operation_config
Substituições de configuração de operação.
Retornos
TagResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
tag_image_in_stream
Esta operação gera uma lista de palavras ou marcas que são relevantes para o conteúdo da imagem fornecida. A API da Pesquisa Visual Computacional pode retornar marcas com base em objetos, seres vivos, cenário ou ações encontradas em imagens. Diferentemente das categorias, as marcas não são organizadas de acordo com um sistema de classificação hierárquica, mas correspondem ao conteúdo da imagem. As marcas podem conter dicas para evitar ambiguidade ou dar contexto, por exemplo, a marca "ascomycota" pode ser acompanhada pela dica "fungo". Há suporte para dois métodos de entrada – (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada em JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.
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 desejada para geração de saída. Se esse parâmetro não for especificado, o valor padrão será "en". Idiomas com suporte:en - inglês, Padrã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 aceitos são: "mais recente", "2021-04-01". O padrão é "mais recente".
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada parte dos dados que são transmitidos. O retorno de chamada deve ter dois argumentos, os bytes da parte atual dos dados e o objeto de resposta. Se os dados estiverem carregando, a resposta será Nenhum.
- operation_config
Substituições de configuração de operação.
Retornos
TagResult ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
Azure SDK for Python