Create AI CM:CASM task

This algorithm allows to detect Child Sexual Abuse Materials (CASM). Generic info about all capabilities and limits see in the generic “Content Moderation” method. What is Child Sexual Abuse Materials detection? This method is intended to prevent this type of content from being distributed over the Internet. For child pornography detection we first run a “soft_nudity” and a “hard_nudity” tasks. If both methods indicate the presence of obscene content with the presence of children (child’s face) in a frame, then such a video is marked as obscene. Frames are designated by the age category of identified children. How to use? The information is returned with the number of the video frame in which the child’s face was found and age. Nudity detection is done using AI, so for each object a probability percentage is applied; objects with a probability of at least 30% are included in the response. Video processing speed is approximately 1:10. Example of detected nudity:

{
"`child_pornography_detected`": true,
"`detection_results`": [ "3-9" ],
"frames": [
{
"`frame_number`": 407,
"label": "`FACE_FEMALE`",
"confidence": 0.78,
"age": "3-9",
"`age_confidence`": 0.65
}...
]
}

Example response without nudity found is empty array:

{
"`child_pornography_detected`": false,
"`detection_results`": [],
"frames": []
}

POST /streaming/ai/tasks#cm_casm

Create AI CM:CASM task

cURL

curl --request POST \
  --url 'https://api.gcore.com/streaming/ai/tasks#cm_casm' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://demo-files.gvideo.io/ai_demo_subtitles_nudity_detection.mp4",
  "task_name": "content-moderation",
  "category": "child_pornography"
}
'

201

{
  "task_id": "aafe70c6-0000-0000-0000-327b65f7670f"
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Body

application/json

task_name · enum<string> · required

Name of the task to be performed

Available options: content-moderation

url · string · required

URL to the MP4 file to analyse. File must be publicly accessible via HTTP/HTTPS.

category · enum<string> · required

AI content moderation with child pornography detection algorithm

Available options: child_pornography

client_user_id · string

Meta parameter, designed to store your own identifier. Can be used by you to tag requests from different end-users. It is not used in any way in video processing.

Maximum string length: 256

client_entity_data · string

Meta parameter, designed to store your own extra information about a video entity: video source, video id, etc. It is not used in any way in video processing. For example, if an AI-task was created automatically when you uploaded a video with the AI auto-processing option (nudity detection, etc), then the ID of the associated video for which the task was performed will be explicitly indicated here.

Maximum string length: 4096

Response

201

application/json

Response returns ID of the created AI task. Using this AI task ID, you can check the status and get the video processing result. Look at GET /ai/results method.

task_id · string<uuid> · required

ID of the created AI task, from which you can get the execution result