Hive content moderation enables you to monitor images and videos in near real-time, for inappropriate content such as nudity, violence, and hate imagery. This page shows you how to use Hive Visual Moderation API in Video SDK for accurate content moderation of live video streams.
Understand the tech
Hive Visual Moderation API and Agora SDK work together as follows:
- The video stream from the channel is encrypted and transmitted to the Agora proxy server.
- The proxy server encapsulates the video stream information, encrypts it, and transmits it to Hive, a third-party moderation service provider.
- The moderation service provider returns the audio and video stream information and review results to your callback server.
- You implement your own business logic based on the review results.
The server-server transmission scheme simplifies monitoring and ensures security of the service. In addition, it gives you complete control over the business logic. When your business server receives a review result indicating content violation, you can close the channel, show a prompt in the UI, ban the user, or deduct points for the client. The intercepted content from the channel is stored using OSS storage services provided by the moderation service provider.
In order to set up Hive content moderation you must have:
- Implemented SDK quickstart for
Interactive Live Streaming using Video SDK
4.0.1, special edition. To download this release, contact firstname.lastname@example.org
- Activated Hive Visual Moderation API on Agora Console.
- Configured Hive Visual Moderation API by sending an email to email@example.com with the following information:
- App ID: Your App ID from Agora Console.
- Detection interval: The time interval between capturing content from a video stream and submitting it for review.
- Content preservation preference: Whether to store all the content submitted for review for later manual review. The default setting is storage for 7 days.
- Callback server address: The address of your
HTTPScallback server that you use to receive review results from Hive. The review effect starts automatically when the user joins the channel and continues for the duration of the call.
Receive review results from Hive
To use Hive, you set up an
HTTPS business server that receives review result callbacks from the moderation service provider. Hive returns review results to your callback URL in the form of an
HTTPS request. The request body contains the
classes array under
output, showing the likelihood
score for each type of content. The following is an example of a review result callback from Hive: