通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

DetectFromUrl interface

  • 参考
包:
@azure-rest/ai-vision-face

方法

post(DetectFromSessionImageIdParameters)

重要

Microsoft已停用或有限的面部识别功能，可用于推断情绪状态和身份属性，如果滥用，可能会使人们受到陈规定型、歧视或不公平拒绝服务。 退休的功能是情感和性别。 有限的功能是年龄、微笑、面部毛发、头发和化妆。 如果你有一个负责任的用例，Azure 人脸 API 电子邮件，这将受益于使用任何有限的功能。 此处阅读有关此决定的详细信息，。

    • 不会存储任何图像。 仅提取的人脸功能存储在服务器上。 faceId 是人脸功能的标识符，将在“标识”、“验证”和“查找相似”中使用。 存储的人脸功能将在原始检测调用后由 faceIdTimeToLive 指定的时间过期并被删除。
    • 可选参数包括 faceId、地标和属性。 属性包括 headPose、眼镜、遮挡、配件、模糊、曝光、噪音、掩码和质量ForRecognition。 为特定属性返回的某些结果可能不太准确。
    • 支持 JPEG、PNG、GIF（第一帧）和 BMP 格式。 允许的图像文件大小从 1KB 到 6MB。
    • 最小可检测人脸大小在图像中不超过 1920x1080 像素的 36x36 像素。 尺寸高于 1920x1080 像素的图像将需要比例更大的最小人脸大小。
    • 最多可以返回 100 张人脸作为图像。 人脸按从大到小的人脸矩形大小进行排名。
    • 若要获得最佳结果，请在查询“识别”、“验证”和“查找相似”（'returnFaceId'为 true）时，请使用正面、清晰且最小大小为 200x200 像素（眼睛之间的 100 像素）的人脸。
    • 可以提供不同的“detectionModel”值。 地标和支持的属性的可用性取决于指定的检测模型。 若要使用和比较不同的检测模型，请参阅此处。
    • 提供了不同的“recognitionModel”值。 如果需要后续操作（如“Verify”、“Identify”、“Find Similar”），请使用“recognitionModel”参数指定识别模型。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请显式指定此参数中所需的模型。 指定后，检测到的 faceId 将与指定的识别模型相关联。 有关详细信息，请参阅此处。
post(DetectFromUrlParameters)

重要

Microsoft已停用或有限的面部识别功能，可用于推断情绪状态和身份属性，如果滥用，可能会使人们受到陈规定型、歧视或不公平拒绝服务。 退休的功能是情感和性别。 有限的功能是年龄、微笑、面部毛发、头发和化妆。 如果你有一个负责任的用例，Azure 人脸 API 电子邮件，这将受益于使用任何有限的功能。 此处阅读有关此决定的详细信息，。

    • 不会存储任何图像。 仅提取的人脸功能存储在服务器上。 faceId 是人脸功能的标识符，将在“标识”、“验证”和“查找相似”中使用。 存储的人脸功能将在原始检测调用后由 faceIdTimeToLive 指定的时间过期并被删除。
    • 可选参数包括 faceId、地标和属性。 属性包括 headPose、眼镜、遮挡、配件、模糊、曝光、噪音、掩码和质量ForRecognition。 为特定属性返回的某些结果可能不太准确。
    • 支持 JPEG、PNG、GIF（第一帧）和 BMP 格式。 允许的图像文件大小从 1KB 到 6MB。
    • 最小可检测人脸大小在图像中不超过 1920x1080 像素的 36x36 像素。 尺寸高于 1920x1080 像素的图像将需要比例更大的最小人脸大小。
    • 最多可以返回 100 张人脸作为图像。 人脸按从大到小的人脸矩形大小进行排名。
    • 若要获得最佳结果，请在查询“识别”、“验证”和“查找相似”（'returnFaceId'为 true）时，请使用正面、清晰且最小大小为 200x200 像素（眼睛之间的 100 像素）的人脸。
    • 可以提供不同的“detectionModel”值。 地标和支持的属性的可用性取决于指定的检测模型。 若要使用和比较不同的检测模型，请参阅此处。
    • 提供了不同的“recognitionModel”值。 如果需要后续操作（如“Verify”、“Identify”、“Find Similar”），请使用“recognitionModel”参数指定识别模型。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请显式指定此参数中所需的模型。 指定后，检测到的 faceId 将与指定的识别模型相关联。 有关详细信息，请参阅此处。
post(DetectParameters)

重要

Microsoft已停用或有限的面部识别功能，可用于推断情绪状态和身份属性，如果滥用，可能会使人们受到陈规定型、歧视或不公平拒绝服务。 退休的功能是情感和性别。 有限的功能是年龄、微笑、面部毛发、头发和化妆。 如果你有一个负责任的用例，Azure 人脸 API 电子邮件，这将受益于使用任何有限的功能。 此处阅读有关此决定的详细信息，。

    • 不会存储任何图像。 仅提取的人脸功能存储在服务器上。 faceId 是人脸功能的标识符，将在“标识”、“验证”和“查找相似”中使用。 存储的人脸功能将在原始检测调用后由 faceIdTimeToLive 指定的时间过期并被删除。
    • 可选参数包括 faceId、地标和属性。 属性包括 headPose、眼镜、遮挡、配件、模糊、曝光、噪音、掩码和质量ForRecognition。 为特定属性返回的某些结果可能不太准确。
    • 支持 JPEG、PNG、GIF（第一帧）和 BMP 格式。 允许的图像文件大小从 1KB 到 6MB。
    • 最小可检测人脸大小在图像中不超过 1920x1080 像素的 36x36 像素。 尺寸高于 1920x1080 像素的图像将需要比例更大的最小人脸大小。
    • 最多可以返回 100 张人脸作为图像。 人脸按从大到小的人脸矩形大小进行排名。
    • 若要获得最佳结果，请在查询“识别”、“验证”和“查找相似”（'returnFaceId'为 true）时，请使用正面、清晰且最小大小为 200x200 像素（眼睛之间的 100 像素）的人脸。
    • 可以提供不同的“detectionModel”值。 地标和支持的属性的可用性取决于指定的检测模型。 若要使用和比较不同的检测模型，请参阅此处。
    • 提供了不同的“recognitionModel”值。 如果需要后续操作（如“Verify”、“Identify”、“Find Similar”），请使用“recognitionModel”参数指定识别模型。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请显式指定此参数中所需的模型。 指定后，检测到的 faceId 将与指定的识别模型相关联。 有关详细信息，请参阅此处。

方法详细信息

post(DetectFromSessionImageIdParameters)

重要

Microsoft已停用或有限的面部识别功能，可用于推断情绪状态和身份属性，如果滥用，可能会使人们受到陈规定型、歧视或不公平拒绝服务。 退休的功能是情感和性别。 有限的功能是年龄、微笑、面部毛发、头发和化妆。 如果你有一个负责任的用例，Azure 人脸 API 电子邮件，这将受益于使用任何有限的功能。 此处阅读有关此决定的详细信息，。

    • 不会存储任何图像。 仅提取的人脸功能存储在服务器上。 faceId 是人脸功能的标识符，将在“标识”、“验证”和“查找相似”中使用。 存储的人脸功能将在原始检测调用后由 faceIdTimeToLive 指定的时间过期并被删除。
    • 可选参数包括 faceId、地标和属性。 属性包括 headPose、眼镜、遮挡、配件、模糊、曝光、噪音、掩码和质量ForRecognition。 为特定属性返回的某些结果可能不太准确。
    • 支持 JPEG、PNG、GIF（第一帧）和 BMP 格式。 允许的图像文件大小从 1KB 到 6MB。
    • 最小可检测人脸大小在图像中不超过 1920x1080 像素的 36x36 像素。 尺寸高于 1920x1080 像素的图像将需要比例更大的最小人脸大小。
    • 最多可以返回 100 张人脸作为图像。 人脸按从大到小的人脸矩形大小进行排名。
    • 若要获得最佳结果，请在查询“识别”、“验证”和“查找相似”（'returnFaceId'为 true）时，请使用正面、清晰且最小大小为 200x200 像素（眼睛之间的 100 像素）的人脸。
    • 可以提供不同的“detectionModel”值。 地标和支持的属性的可用性取决于指定的检测模型。 若要使用和比较不同的检测模型，请参阅此处。
    • 提供了不同的“recognitionModel”值。 如果需要后续操作（如“Verify”、“Identify”、“Find Similar”），请使用“recognitionModel”参数指定识别模型。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请显式指定此参数中所需的模型。 指定后，检测到的 faceId 将与指定的识别模型相关联。 有关详细信息，请参阅此处。
function post(options: DetectFromSessionImageIdParameters): StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

参数

options
DetectFromSessionImageIdParameters

返回

StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

post(DetectFromUrlParameters)

重要

Microsoft已停用或有限的面部识别功能，可用于推断情绪状态和身份属性，如果滥用，可能会使人们受到陈规定型、歧视或不公平拒绝服务。 退休的功能是情感和性别。 有限的功能是年龄、微笑、面部毛发、头发和化妆。 如果你有一个负责任的用例，Azure 人脸 API 电子邮件，这将受益于使用任何有限的功能。 此处阅读有关此决定的详细信息，。

    • 不会存储任何图像。 仅提取的人脸功能存储在服务器上。 faceId 是人脸功能的标识符，将在“标识”、“验证”和“查找相似”中使用。 存储的人脸功能将在原始检测调用后由 faceIdTimeToLive 指定的时间过期并被删除。
    • 可选参数包括 faceId、地标和属性。 属性包括 headPose、眼镜、遮挡、配件、模糊、曝光、噪音、掩码和质量ForRecognition。 为特定属性返回的某些结果可能不太准确。
    • 支持 JPEG、PNG、GIF（第一帧）和 BMP 格式。 允许的图像文件大小从 1KB 到 6MB。
    • 最小可检测人脸大小在图像中不超过 1920x1080 像素的 36x36 像素。 尺寸高于 1920x1080 像素的图像将需要比例更大的最小人脸大小。
    • 最多可以返回 100 张人脸作为图像。 人脸按从大到小的人脸矩形大小进行排名。
    • 若要获得最佳结果，请在查询“识别”、“验证”和“查找相似”（'returnFaceId'为 true）时，请使用正面、清晰且最小大小为 200x200 像素（眼睛之间的 100 像素）的人脸。
    • 可以提供不同的“detectionModel”值。 地标和支持的属性的可用性取决于指定的检测模型。 若要使用和比较不同的检测模型，请参阅此处。
    • 提供了不同的“recognitionModel”值。 如果需要后续操作（如“Verify”、“Identify”、“Find Similar”），请使用“recognitionModel”参数指定识别模型。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请显式指定此参数中所需的模型。 指定后，检测到的 faceId 将与指定的识别模型相关联。 有关详细信息，请参阅此处。
function post(options: DetectFromUrlParameters): StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

参数

options
DetectFromUrlParameters

返回

StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

post(DetectParameters)

重要

Microsoft已停用或有限的面部识别功能，可用于推断情绪状态和身份属性，如果滥用，可能会使人们受到陈规定型、歧视或不公平拒绝服务。 退休的功能是情感和性别。 有限的功能是年龄、微笑、面部毛发、头发和化妆。 如果你有一个负责任的用例，Azure 人脸 API 电子邮件，这将受益于使用任何有限的功能。 此处阅读有关此决定的详细信息，。

    • 不会存储任何图像。 仅提取的人脸功能存储在服务器上。 faceId 是人脸功能的标识符，将在“标识”、“验证”和“查找相似”中使用。 存储的人脸功能将在原始检测调用后由 faceIdTimeToLive 指定的时间过期并被删除。
    • 可选参数包括 faceId、地标和属性。 属性包括 headPose、眼镜、遮挡、配件、模糊、曝光、噪音、掩码和质量ForRecognition。 为特定属性返回的某些结果可能不太准确。
    • 支持 JPEG、PNG、GIF（第一帧）和 BMP 格式。 允许的图像文件大小从 1KB 到 6MB。
    • 最小可检测人脸大小在图像中不超过 1920x1080 像素的 36x36 像素。 尺寸高于 1920x1080 像素的图像将需要比例更大的最小人脸大小。
    • 最多可以返回 100 张人脸作为图像。 人脸按从大到小的人脸矩形大小进行排名。
    • 若要获得最佳结果，请在查询“识别”、“验证”和“查找相似”（'returnFaceId'为 true）时，请使用正面、清晰且最小大小为 200x200 像素（眼睛之间的 100 像素）的人脸。
    • 可以提供不同的“detectionModel”值。 地标和支持的属性的可用性取决于指定的检测模型。 若要使用和比较不同的检测模型，请参阅此处。
    • 提供了不同的“recognitionModel”值。 如果需要后续操作（如“Verify”、“Identify”、“Find Similar”），请使用“recognitionModel”参数指定识别模型。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请显式指定此参数中所需的模型。 指定后，检测到的 faceId 将与指定的识别模型相关联。 有关详细信息，请参阅此处。
function post(options: DetectParameters): StreamableMethod<Detect200Response | DetectDefaultResponse>

参数

options
DetectParameters

返回

StreamableMethod<Detect200Response | DetectDefaultResponse>