Generate named entities

This endpoint allows you to extract named entities from an existing media.
Named Entity Recognition (NER) is a fundamental natural language processing (NLP) technique that identifies and classifies key information (entities) in text into predefined categories. For instance:

• Organizations (e.g., "Microsoft", "United Nations")
• Locations (e.g., "Paris", "Mount Everest")
• Product names (e.g., "iPhone", "Coca-Cola")

How it works

1. Make a PATCH request to the /on-demand/{mediaId}/named-entities endpoint, replacing <mediaId> with the ID of the media you want to extract named-entities.
2. Include the namedEntities parameter in the request body to enable.
3. Receive a response containing the updated media data, confirming the changes made.

You can utilise the video.mediaAI.named-entities.ready webhook event to track and notify about the named entities extraction.

Use case: If a user uploads a video and later decides to enable named entity extraction without re-uploading the entire video.