Partilhar via

DetectFromUrl interface

Pacote:
@azure-rest/ai-vision-face

Métodos

post(DetectFromSessionImageIdParameters)

Importante

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. E-mail API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte aqui.
post(DetectFromUrlParameters)

Importante

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. E-mail API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte aqui.
post(DetectParameters)

Importante

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. E-mail API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte aqui.

Detalhes de Método

post(DetectFromSessionImageIdParameters)

Importante

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. E-mail API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte aqui.
function post(options: DetectFromSessionImageIdParameters): StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

Parâmetros

options
DetectFromSessionImageIdParameters

Devoluções

StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

post(DetectFromUrlParameters)

Importante

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. E-mail API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte aqui.
function post(options: DetectFromUrlParameters): StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

Parâmetros

options
DetectFromUrlParameters

Devoluções

StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

post(DetectParameters)

Importante

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. E-mail API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte aqui.
function post(options: DetectParameters): StreamableMethod<Detect200Response | DetectDefaultResponse>

Parâmetros

options
DetectParameters

Devoluções

StreamableMethod<Detect200Response | DetectDefaultResponse>