Skip to content

Commit 85e1401

Browse files
authored
Merge pull request #3750 from PatrickFarley/freshness-pass
Freshness pass
2 parents fe8edee + 95287d9 commit 85e1401

16 files changed

+69
-68
lines changed

Diff for: articles/ai-services/cognitive-services-limited-access.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: PatrickFarley
66
manager: nitinme
77
ms.service: azure-ai-services
88
ms.topic: conceptual
9-
ms.date: 09/18/2024
9+
ms.date: 03/26/2025
1010
ms.author: pafarley
1111
---
1212

@@ -27,7 +27,7 @@ The following services are Limited Access:
2727
- [Custom Neural Voice](/legal/cognitive-services/speech-service/text-to-speech/limited-access?context=/azure/ai-services/speech-service/context/context): Pro features
2828
- [Custom text to speech avatar](/legal/cognitive-services/speech-service/text-to-speech/limited-access?context=/azure/ai-services/speech-service/context/context): All features
2929
- [Speaker Recognition](/legal/cognitive-services/speech-service/speaker-recognition/limited-access-speaker-recognition?context=/azure/ai-services/speech-service/context/context): All features
30-
- [Face API](/legal/cognitive-services/computer-vision/limited-access-identity?context=/azure/ai-services/computer-vision/context/context): Identify and Verify features, face ID property
30+
- [Azure AI Face](/legal/cognitive-services/computer-vision/limited-access-identity?context=/azure/ai-services/computer-vision/context/context): Identify and Verify features, face ID property
3131
- [Azure AI Vision](/legal/cognitive-services/computer-vision/limited-access?context=/azure/ai-services/computer-vision/context/context): Celebrity Recognition feature
3232
- [Azure AI Video Indexer](/azure/azure-video-indexer/limited-access-features): Celebrity Recognition and Face Identify features
3333
- [Azure OpenAI](/legal/cognitive-services/openai/limited-access): Azure OpenAI Service, modified abuse monitoring, and modified content filters
@@ -43,7 +43,7 @@ Submit a registration form for each Limited Access service you would like to use
4343
- [Custom Neural Voice](https://aka.ms/customneural): Pro features
4444
- [Custom text to speech avatar](https://aka.ms/customneural): All features
4545
- [Speaker Recognition](https://aka.ms/azure-speaker-recognition): All features
46-
- [Face API](https://aka.ms/facerecognition): Identify and Verify features
46+
- [Azure AI Face](https://aka.ms/facerecognition): Identify and Verify features
4747
- [Azure AI Vision](https://aka.ms/facerecognition): Celebrity Recognition feature
4848
- [Azure AI Video Indexer](https://aka.ms/facerecognition): Celebrity Recognition and Face Identify features
4949
- [Azure OpenAI](/legal/cognitive-services/openai/limited-access): Azure OpenAI Service, modified abuse monitoring, and modified content filters

Diff for: articles/ai-services/computer-vision/concept-face-detection.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.subservice: azure-ai-face
1010
ms.custom:
1111
- ignite-2023
1212
ms.topic: conceptual
13-
ms.date: 09/18/2024
13+
ms.date: 03/26/2025
1414
ms.author: pafarley
1515
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1616
---
@@ -20,11 +20,11 @@ feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
2020
[!INCLUDE [Gate notice](./includes/identity-gate-notice.md)]
2121

2222
> [!IMPORTANT]
23-
> Face attributes are predicted through the use of statistical algorithms. They might not always be accurate. Use caution when you make decisions based on attribute data. Please refrain from using these attributes for anti-spoofing. Instead, we recommend using Face Liveness detection. For more information, please refer to [Tutorial: Detect liveness in faces](/azure/ai-services/computer-vision/tutorials/liveness).
23+
> Face attributes are predicted by statistical algorithms. They might not always be accurate. Use caution when you make decisions based on attribute data. Refrain from using these attributes for anti-spoofing. Instead, we recommend using Face Liveness detection. For more information, please refer to [Tutorial: Detect liveness in faces](/azure/ai-services/computer-vision/tutorials/liveness).
2424
2525
This article explains the concepts of face detection and face attribute data. Face detection is the process of locating human faces in an image and optionally returning different kinds of face-related data.
2626

27-
You use the [Detect] API to detect faces in an image. To get started using the REST API or a client SDK, follow a [Face service quickstart](./quickstarts-sdk/identity-client-library.md). Or, for a more in-depth guide, see [Call the detect API](./how-to/identity-detect-faces.md).
27+
You use the [Detect] API to detect faces in an image. To get started using the REST API or a client SDK, follow a [Face service quickstart](./quickstarts-sdk/identity-client-library.md). Or, for a more in-depth guide, see [Call the Detect API](./how-to/identity-detect-faces.md).
2828

2929
## Face rectangle
3030

Diff for: articles/ai-services/computer-vision/concept-object-detection.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,17 @@ manager: nitinme
77

88
ms.service: azure-ai-vision
99
ms.topic: conceptual
10-
ms.date: 09/19/2024
10+
ms.date: 03/26/2025
1111
ms.author: pafarley
1212
---
1313

1414
# Object detection
1515

16-
This article explains the concept of object detection. Object detection is similar to [tagging](concept-tag-images-40.md), but the API returns the bounding box coordinates (in pixels) for each object found in the image. For example, if an image contains a dog, cat, and person, the object detection operation lists those objects with their coordinates in the image. You can use this functionality to process the relationships between the objects in an image. It also lets you determine whether there are multiple instances of the same object in an image.
16+
This article explains the object detection feature. Object detection is similar to [tagging](concept-tag-images-40.md), but the API returns the bounding box coordinates (in pixels) for each object found in the image. For example, if an image contains a dog, cat, and person, the object detection operation lists those objects with their coordinates in the image.
1717

18-
The object detection function applies tags based on the objects or living things identified in the image. There's no formal relationship between the tagging taxonomy and the object detection taxonomy. At a conceptual level, the object detection function only finds objects and living things, while the tag function can also include contextual terms like *indoor*, which can't be localized with bounding boxes.
18+
You can use this functionality to process the relationships between the objects in an image. It also lets you determine whether there are multiple instances of the same object in an image.
19+
20+
There's no formal relationship between the tagging taxonomy and the object detection taxonomy. At a conceptual level, the object detection function only finds objects and living things, while the tag function can also include contextual terms like *indoor*, which can't be localized with bounding boxes.
1921

2022
Try out the capabilities of object detection quickly and easily in your browser by using Azure AI Vision Studio.
2123

Diff for: articles/ai-services/computer-vision/identity-api-reference.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
title: API Reference - Face
33
titleSuffix: Azure AI services
44
description: API reference provides information about the Person, LargePersonGroup/PersonGroup, LargeFaceList/FaceList, and Face Algorithms APIs.
5-
author: nitinme
5+
author: PatrickFarley
66
manager: nitinme
77

88
ms.service: azure-ai-vision
99
ms.subservice: azure-ai-face
1010
ms.topic: conceptual
11-
ms.date: 02/17/2021
12-
ms.author: nitinme
11+
ms.date: 03/26/2025
12+
ms.author: pafarley
1313
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1414
---
1515

Diff for: articles/ai-services/computer-vision/tutorials/liveness.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.subservice: azure-ai-face
88
ms.custom:
99
- ignite-2023
1010
ms.topic: tutorial
11-
ms.date: 09/25/2024
11+
ms.date: 03/26/2025
1212
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1313
---
1414

Diff for: articles/ai-services/content-safety/how-to/containers/container-overview.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: PatrickFarley
66
manager: nitinme
77
ms.service: azure-ai-content-safety
88
ms.topic: overview
9-
ms.date: 09/23/2024
9+
ms.date: 03/26/2025
1010
ms.author: pafarley
1111
keywords: on-premises, Docker, container
1212
---
@@ -17,7 +17,7 @@ Containers let you use a subset of the Azure AI Content Safety features in your
1717

1818
## Available containers
1919

20-
The following table lists the content safety containers available in the Microsoft Container Registry (MCR). The table also lists the features supported by each container and the latest version of the container.
20+
The following table lists the content safety containers available in the Microsoft Container Registry (MCR). The table also lists the features supported by each container and the latest version of the container.
2121

2222
| Container | Features |
2323
|--------------------------------------|----------|
@@ -37,7 +37,7 @@ The request form takes information about you, your company, and the user scenari
3737

3838
After you submit the form, the Azure AI services team reviews it and emails you with a decision within 10 business days.
3939

40-
## Billing
40+
## Billing information
4141

4242
The content safety containers send billing information to Azure through the content safety resource in your Azure account.
4343

Diff for: articles/ai-services/content-safety/how-to/embedded-content-safety.md

+26-29
Original file line numberDiff line numberDiff line change
@@ -6,97 +6,94 @@ author: PatrickFarley
66
manager: nitinme
77
ms.service: azure-ai-content-safety
88
ms.topic: how-to
9-
ms.date: 9/24/2024
10-
ms.author: zhanxia
9+
ms.date: 03/26/2025
10+
ms.author: pafarley
1111
---
1212

1313
# Embedded content safety (preview)
1414

15-
Embedded content safety is designed for on-device scenarios where cloud connectivity is intermittent or prefer on-device for privacy reason. For example, you can use embedded content safety in a PC to detect harmful content generated by foundation model, or a car that might travel out of range. You can also develop hybrid cloud and offline solutions. For scenarios where your devices must be in a secure environment like a bank or government entity, you should first consider [disconnected containers](../../containers/disconnected-containers.md).
15+
Embedded content safety is designed for on-device scenarios where cloud connectivity is intermittent or the user prefers on-device access for privacy reasons.
16+
17+
You can use embedded content safety locally on a PC to detect harmful content generated by a large language model, or in a car that might travel out of a specified range. You can also develop hybrid cloud and offline solutions. For scenarios where your devices must be in a secure environment like a bank or government entity, you should first consider [disconnected containers](../../containers/disconnected-containers.md).
1618

1719
> [!IMPORTANT]
18-
> Microsoft limits access to embedded content safety. You can apply for access through the Azure AI content safety [embedded content safety limited access review](https://aka.ms/aacs-embedded-application). For more information, see [Limited access](../limited-access.md).
20+
> Microsoft limits access to embedded content safety. You can apply for access through the Azure AI content safety [embedded content safety limited access review](https://aka.ms/aacs-embedded-application). Instructions are provided upon successful completion of the limited access review process. For more information, see [Limited access](../limited-access.md).
1921
2022
## Platform requirements
2123

22-
Embedded content safety is included with the content safety C++ SDK.
23-
24-
**Choose your target environment**
24+
Embedded content safety is included with the Azure AI Content Safety C++ SDK.
2525

26-
Embedded content safety only supports Windows right now. Contact your Microsoft account contact if you need to run embedded content safety on a different platform.
26+
### Choose your target environment
2727

28-
# [Windows X64](#tab/windows-target)
28+
Embedded content safety only supports Windows. Contact your Microsoft account administrator if you need to run embedded content safety on a different platform.
2929

3030
Requires Windows 10 or newer on x64 hardware.
3131

3232
The latest [Microsoft Visual C++ Redistributable for Visual Studio 2015-2022](/cpp/windows/latest-supported-vc-redist?view=msvc-170&preserve-view=true) must be installed regardless of the programming language used with the content safety SDK.
3333

34-
---
3534

3635
## Limitations
3736

38-
Embedded content safety is only available with C++ SDK. The other content safety SDKs, and REST APIs don't support embedded content safety.
37+
Embedded content safety is only available with the C++ SDK. The other Content Safety SDKs and REST APIs don't support embedded content safety.
3938

4039

4140
## Embedded content safety SDK packages
4241

4342

44-
For C++ embedded applications, install following content safety SDK for C++ packages:
43+
For C++ embedded applications, install the following C++ packages:
4544

4645
|Package |Description |
4746
| --------- | --------- |
4847
|[Azure.AI.ContentSafety.Extension.Embedded.Text](https://www.nuget.org/packages/Azure.AI.ContentSafety.Extension.Embedded.Text)|Required to run text analysis on device|
4948
|[Azure.AI.ContentSafety.Extension.Embedded.Image](https://www.nuget.org/packages/Azure.AI.ContentSafety.Extension.Embedded.Image)|Required to run image analysis on device|
5049

5150

52-
53-
5451
## Models
5552

56-
For embedded content safety, you need to download the content safety to your device. Microsoft limits access to embedded content safety. You can apply for access through the [embedded content safety limited access review](https://aka.ms/aacs-embedded-application). Instructions are provided upon successful completion of the limited access review process.
53+
For embedded content safety, you need to download the content safety to your device.
5754

58-
The embedded content safety supports [analyze text](../quickstart-text.md) and [analyze image](../quickstart-image.md) features. These features scan text or image content for sexual content, violence, hate, and self-harm with multiple severity levels. It should be noted that these embedded models have been optimized for on-device execution with less computational resources compared to the Azure API. Therefore, it's possible that the output generated from the embedded content safety model may vary from that of the Azure API.
55+
The embedded content safety supports [Analyze text](../quickstart-text.md) and [Analyze image](../quickstart-image.md) features. These features scan text or image content for sexual content, violence, hate, and self-harm with multiple severity levels.
5956

57+
These embedded models have been optimized for on-device execution with less computational resources compared to the Azure API. Therefore, it's possible that the output generated from the embedded content safety model may vary from that of the Azure API.
6058

61-
## Embedded content safety code samples
6259

63-
Below is the ready to use embedded content safety samples. Follow the readme file to run the sample.
60+
## Code samples
6461

65-
1. [C++ sample](https://github.com/Azure/azure-ai-content-safety-sdK)
62+
Below is the ready-to-use embedded content safety sample. Follow the readme file to run the sample.
6663

64+
- [C++ sample](https://github.com/Azure/azure-ai-content-safety-sdK)
6765

6866

6967
## Performance evaluations
7068

71-
Embedded content safety models run fully on your target devices. Understanding the performance characteristics of these models on your devices hardware can be critical to delivering low latency experiences within your products and applications. This section provides information to help answer the question, "Is my device suitable to run embedded content safety for text analysis or image analysis?"
69+
Embedded content safety models run fully on your target devices. Understanding the performance characteristics of these models on your devices' hardware can be critical to delivering low latency experiences within your products and applications. This section provides information to help determine if your device is suitable to run embedded content safety for text analysis or image analysis.
7270

7371
### Factors that affect performance
74-
Device specifications – The specifications of your device play a key role in whether embedded content safety models can run without performance issues. CPU clock speed, architecture (for example, x64, ARM processor, etcetera), and memory can all affect model inference speed.
7572

76-
CPU/GPU load – In most cases, your device is running other applications in parallel to the application where embedded content safety models are integrated. The amount of CPU/GPU load your device experiences when idle and at peak can also affect performance.
73+
**Device specifications** – The specifications of your device play a key role in whether embedded content safety models can run without performance issues. CPU clock speed, architecture (for example, x64, ARM processor, etcetera), and memory can all affect model inference speed.
74+
75+
**CPU/GPU load** – In most cases, your device is running other applications in parallel to the application where embedded content safety models are integrated. The amount of CPU/GPU load your device experiences when idle and at peak can also affect performance.
7776

7877
For example, if the device is under moderate to high CPU load from all other applications running on the device, it's possible to encounter performance issues for running embedded content safety in addition to the other applications, even with a powerful processor.
7978

80-
Memory load – An embedded content safety text analysis process consumes about 900 MB of memory at runtime. If your device has less memory available for the embedded content safety process to use, frequent fallbacks to virtual memory and paging can introduce more latencies. This can affect both the real-time factor and user-perceived latency.
79+
**Memory load** – An embedded content safety text analysis process consumes about 900 MB of memory at runtime. If your device has less memory available for the embedded content safety process to use, frequent fallbacks to virtual memory and paging can introduce more latencies. This can affect both the real-time factor and user-perceived latency.
8180

82-
### SDK parameters that can impact performance
81+
### SDK parameters that can affect performance
8382

8483
The following SDK parameters can impact the inference time of the embedded content safety model.
8584

8685
- `gpuEnabled` Set as **true** to enable GPU, otherwise CPU is used. Generally inference time is shorter on GPU.
8786
- `numThreads` This parameter only works for CPU. It defines number of threads to be used in a multi-threaded environment. We support a maximum number of four threads.
8887

89-
See next section for performance benchmark data on popular PC CPUs and GPUs.
90-
9188

9289
### Performance benchmark data on popular CPUs and GPUs
9390

94-
As stated above, there are multiple factors that impact the performance of embedded content safety model. We highly suggest you test it on your device and tweak the parameters to fit for your application's requirement.
91+
As stated above, there are multiple factors that impact the performance of an embedded content safety model. We highly recommend you test it on your device and tweak the parameters to fit for your application's requirements.
9592

9693
We also conduct performance benchmark tests on various popular PC CPUs and GPUs. Keep in mind that even with the same CPU, performance can vary depending on the CPU and memory load. The benchmark data provided should serve as a reference when considering if the embedded content safety can operate on your device. For optimal results, we advise testing on your intended device and in your specific application scenario.
9794

9895

99-
The [sample code](https://github.com/Azure/azure-ai-content-safety-sdk) includes code snippet to monitor performance metrics like memory, inference time.
96+
The [sample code](#code-samples) includes code snippets to monitor performance metrics like memory, inference time.
10097

10198
#### [Text analysis performance](#tab/text)
10299

@@ -166,6 +163,6 @@ The [sample code](https://github.com/Azure/azure-ai-content-safety-sdk) includes
166163

167164
---
168165

169-
## Related Content
166+
## Related content
170167

171168
- [Limited access to Content Safety](../limited-access.md)

0 commit comments

Comments
 (0)