Enhance Privacy with Auto-Blurring of Faces and License Plates Using Cognitive Actions

24 Apr 2025
Enhance Privacy with Auto-Blurring of Faces and License Plates Using Cognitive Actions

In today's digital landscape, protecting privacy is more critical than ever. The stphtan94117/auto-blurring-of-faces-and-license_plates Cognitive Actions provide a robust solution to automatically blur faces and license plates in images and videos. Leveraging these pre-built actions can help developers integrate effective privacy protection into their applications with minimal effort. This blog post will guide you through the capabilities of these actions, how to implement them, and their potential use cases.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic familiarity with making HTTP requests and handling JSON data.
  • A development environment set up to test API calls (e.g., Python and the requests library).

To authenticate your requests, you will typically pass your API key in the request headers, allowing you to securely access the Cognitive Actions services.

Cognitive Actions Overview

Blur Faces and License Plates

Description: This action automatically blurs faces and license plates in images and videos, preserving privacy. It allows customization of blur intensity, object classes, and more, ensuring effective privacy protection through parameter tuning.

Category: image-privacy-blurring

Input

The action requires the following input parameters:

  • file (required): The URI of the input file (supports all photo and video formats).
  • blur (optional): The amount of blur to apply, ranging from 1 (least blur) to 100 (most blur). Default value is 35.
  • size (optional): The inference size, with options: 640, 720, or 1280. Default value is 1280.
  • classes (optional): The classes of objects to blur: face, license_plate, or All. Default is All.
  • iouThreshold (optional): Intersection over Union (IoU) threshold for Non-Maximum Suppression (NMS), ranging from 0 to 1. Default is 0.45.
  • lineThickness (optional): The thickness of the polygon outline in pixels, ranging from 1 to 10. Default is 3.
  • hideBoundingBox (optional): Boolean flag to hide the bounding box around detected objects. Default is true.
  • confidenceThreshold (optional): Confidence threshold for predictions, ranging from 0 to 1. Default is 0.25.

Example Input:

{
  "blur": 35,
  "file": "https://replicate.delivery/pbxt/JTpA5ETnu2fk84k1ovEQ8JJZuCKnBFXoUbSDH9kG88Ve8CwS/1.jpg",
  "size": "1280",
  "classes": "All",
  "iouThreshold": 0.45,
  "lineThickness": 3,
  "hideBoundingBox": true,
  "confidenceThreshold": 0.25
}

Output

The action typically returns a URL to the processed image with faces and license plates blurred.

Example Output:

https://assets.cognitiveactions.com/invocations/e1bf5f3c-821e-4c95-9fe9-3a7488ac93c6/7bd04af5-a4cf-4de8-9236-5b4ffb949464.jpg

Conceptual Usage Example (Python)

Here’s a conceptual example of how you might call this action using Python:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "4a0d295b-6445-4718-84a6-940e431c0f13"  # Action ID for Blur Faces and License Plates

# Construct the input payload based on the action's requirements
payload = {
    "blur": 35,
    "file": "https://replicate.delivery/pbxt/JTpA5ETnu2fk84k1ovEQ8JJZuCKnBFXoUbSDH9kG88Ve8CwS/1.jpg",
    "size": "1280",
    "classes": "All",
    "iouThreshold": 0.45,
    "lineThickness": 3,
    "hideBoundingBox": True,
    "confidenceThreshold": 0.25
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this example, the action_id corresponds to the "Blur Faces and License Plates" action. The payload contains the required parameters formatted as specified. The endpoint URL and request structure are illustrative and may differ in a real implementation.

Conclusion

The stphtan94117/auto-blurring-of-faces-and-license_plates Cognitive Action is a powerful tool for developers looking to enhance privacy in their applications. By automating the blurring of sensitive information, you can ensure better compliance with privacy regulations and improve user trust.

Next steps might include experimenting with different blur intensities or object classes to fine-tune the functionality to your specific needs. With these Cognitive Actions, protecting user privacy has never been easier!

← Back to All Articles