1# Azure AI Content Safety — Java SDK Quick Reference
2 
3> Condensed from **azure-ai-contentsafety-java**. Full patterns (blocklist management, image moderation, 8-severity)
4> in the **azure-ai-contentsafety-java** plugin skill if installed.
5 
6## Install
7```xml
8<dependency>
9  <groupId>com.azure</groupId>
10  <artifactId>azure-ai-contentsafety</artifactId>
11  <version>1.1.0-beta.1</version>
12</dependency>
13```
14 
15## Quick Start
16```java
17import com.azure.ai.contentsafety.ContentSafetyClient;
18import com.azure.ai.contentsafety.ContentSafetyClientBuilder;
19import com.azure.ai.contentsafety.BlocklistClient;
20import com.azure.ai.contentsafety.BlocklistClientBuilder;
21ContentSafetyClient client = new ContentSafetyClientBuilder()
22    .endpoint(endpoint).credential(credential).buildClient();
23```
24 
25## Non-Obvious Patterns
26- Two separate builders: `ContentSafetyClientBuilder` and `BlocklistClientBuilder`
27- Image from file: `new ContentSafetyImageData().setContent(BinaryData.fromBytes(bytes))`
28- Image from URL: `new ContentSafetyImageData().setBlobUrl(url)`
29- Blocklist create uses raw `BinaryData` + `RequestOptions` (not typed model)
30 
31## Best Practices
321. Blocklist changes take ~5 minutes to take effect
332. Only request needed categories to reduce latency
343. Typically block severity >= 4 for strict moderation
354. Process multiple items in parallel for throughput
365. Cache blocklist results where appropriate
37