Partilhar via


Analyze Image By Domain - 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.

POST {Endpoint}/vision/v3.2/models/{model}/analyze
POST {Endpoint}/vision/v3.2/models/{model}/analyze?language={language}&model-version={model-version}

Parâmetros do URI

Name Em Necessário Tipo Description
Endpoint
path True

string

Pontos finais dos Serviços Cognitivos suportados.

model
path True

string

O conteúdo específico do domínio a reconhecer.

language
query

string

O idioma pretendido para a geração de saída. Se este parâmetro não for especificado, o valor predefinido é "en". Veja https://aka.ms/cv-languages a lista de idiomas suportados.

model-version
query

string

Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceites são: "latest", "2021-04-01", "2021-05-01". A predefinição é "mais recente".

Padrão Regex: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

Cabeçalho do Pedido

Name Necessário Tipo Description
Ocp-Apim-Subscription-Key True

string

Corpo do Pedido

Name Necessário Tipo Description
url True

string

URL acessível publicamente de uma imagem.

Respostas

Name Tipo Description
200 OK

DomainModelResults

Resultado da análise com base no modelo de domínio.

Other Status Codes

ComputerVisionErrorResponse

Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Successful AnalyzeImageByDomain request

Pedido de amostra

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/models/Celebrities/analyze


{
  "url": "{url}"
}

Resposta da amostra

{
  "requestId": "f0027b4b-dc0d-4082-9228-1545ed246b03",
  "metadata": {
    "width": 1500,
    "height": 1000,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01",
  "result": {
    "celebrities": [
      {
        "name": "Satya Nadella",
        "faceRectangle": {
          "left": 597,
          "top": 162,
          "width": 248,
          "height": 248
        },
        "confidence": 0.999028444
      }
    ]
  }
}

Definições

Name Description
ComputerVisionError

O erro do pedido de API.

ComputerVisionErrorCodes

O código de erro.

ComputerVisionErrorResponse

A resposta ao erro da API.

ComputerVisionInnerError

Detalhes sobre o erro do pedido de API.

ComputerVisionInnerErrorCodeValue

O código de erro.

DomainModelResults

Resultado da análise de imagens com um modelo de domínio específico, incluindo metadados adicionais.

ImageMetadata

Metadados de imagem.

ImageUrl

ComputerVisionError

O erro do pedido de API.

Name Tipo Description
code

ComputerVisionErrorCodes

O código de erro.

innererror

ComputerVisionInnerError

O erro interno contém informações mais específicas.

message

string

Uma mensagem a explicar o erro comunicado pelo serviço.

ComputerVisionErrorCodes

O código de erro.

Name Tipo Description
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

A resposta ao erro da API.

Name Tipo Description
error

ComputerVisionError

Conteúdo do erro.

ComputerVisionInnerError

Detalhes sobre o erro do pedido de API.

Name Tipo Description
code

ComputerVisionInnerErrorCodeValue

O código de erro.

message

string

Mensagem de erro.

ComputerVisionInnerErrorCodeValue

O código de erro.

Name Tipo Description
BadArgument

string

CancelledRequest

string

DetectFaceError

string

FailedToProcess

string

InternalServerError

string

InvalidDetails

string

InvalidImageFormat

string

InvalidImageSize

string

InvalidImageUrl

string

InvalidModel

string

InvalidThumbnailSize

string

NotSupportedFeature

string

NotSupportedImage

string

NotSupportedLanguage

string

NotSupportedVisualFeature

string

StorageException

string

Timeout

string

Unspecified

string

UnsupportedMediaType

string

DomainModelResults

Resultado da análise de imagens com um modelo de domínio específico, incluindo metadados adicionais.

Name Tipo Description
metadata

ImageMetadata

Metadados de imagem.

modelVersion

string

Versão do modelo de IA.

requestId

string

ID do pedido da API REST.

ImageMetadata

Metadados de imagem.

Name Tipo Description
format

string

Formato de imagem.

height

integer

Altura da imagem, em píxeis.

width

integer

Largura da imagem, em píxeis.

ImageUrl

Name Tipo Description
url

string

URL acessível publicamente de uma imagem.