Subscribe to In-Video AI events | FastPix Developer Documentation

FastPix’s in-video AI events provide insights into the analysis and processing of media content. These events include:

video.mediaAI.chapters.ready

This event is triggered when chapters are generated for a media file. It provides information about the chapters within the media, including their start and end times, titles, and summaries. The event also indicates if chapters were successfully generated. This can be used to track when chapters are created and monitor the structure of the content for easier navigation.

Field	Type	Description
type	string	Type for the webhook event.
id	string	Unique identifier for the event.
workspace	object	Workspace information.
workspace.name	string	Name of the workspace.
workspace.id	string	Unique ID for the workspace (e.g., “a56a1e42-65ec-4f9d-9fc1-89d24cd59348”).
status	string	Status of the media. Possible values: `"ready"`.
data	object	Data related to the media event.
-data.isChaptersGenerated	boolean	Indicates if chapters were generated (`true` / `false`).
-data.chapters	array	List of chapters for the media.
-data.chapters[].chapter	string	Chapter number (e.g., “1”).
-data.chapters[].startTime	string	Start time of the chapter (e.g., “00:00:00”).
-data.chapters[].endTime	string	End time of the chapter (e.g., “00:00:52”).
-data.chapters[].title	string	Title of the chapter.
-data.chapters[].summary	string	Summary of the chapter.
createdAt	string	Timestamp when the event was created (e.g., “2025-01-17T05:52:14.088348957Z”).
attempts	array	List of attempts, if any.

video.mediaAI.namedEntities.ready

This event is triggered when named entities are identified within a media file. It provides details about the named entities, including their count, the entity name, and their associated category. This event can be used to track the recognition of specific entities, such as people, organizations, or locations, within the content, allowing for enhanced analysis and insights.

Name	Type	Description
type	string	Type for the webhook event.
id	string	Unique identifier for the event.
workspace	object	Workspace information.
workspace.name	string	Name of the workspace.
workspace.id	string	Unique identifier for the workspace (e.g., “a56a1e42-65ec-4f9d-9fc1-89d24cd59348”).
status	string	Status of the media. Possible values: `"ready"`.
-data	object	Data related to the media event.
-data.isNamedEntitiesGenerated	boolean	Indicates if named entities were generated (`true` / `false`).
-data.namedEntities	object	Information about the named entities.
-data.namedEntities.entityCount	integer	Count of the named entities generated (e.g., 2).
-data.namedEntities.namedEntities	array	List of named entities identified in the media.
-data.namedEntities.namedEntities[].entity	string	The named entity.
-data.namedEntities.namedEntities[].category	string	Category of the named entity.
createdAt	string	Timestamp when the event was created (e.g., “2025-01-17T05:52:19.601920651Z”).
attempts	array	List of attempts, if any.

video.mediaAI.summary.ready

This event is triggered when a summary is generated for a media file. It provides the summary of the content, offering a brief overview or key points of the media. This event can be used to track when summaries are created, helping users or systems quickly understand the essence of the media without needing to watch or listen to the entire content.

Name	Type	Description
type	string	Type for the webhook event.
id	string	Unique identifier for the event.
workspace	object	Workspace information.
workspace.name	string	Name of the workspace.
workspace.id	string	Unique identifier for the workspace (e.g., “a56a1e42-65ec-4f9d-9fc1-89d24cd59348”).
status	string	Status of the media. Possible values: `"ready"`.
data	object	Data related to the media event.
-data.isSummaryGenerated	boolean	Indicates if a summary was generated (`true` / `false`).
-data.summary	string	The summary of the media content.
createdAt	string	Timestamp when the event was created (e.g., “2025-01-17T05:52:27.333581529Z”).
attempts	array	List of attempts, if any.

video.mediaAI.moderation.ready

This event is triggered when moderation results are generated for a media file. It provides information about the moderation analysis, including category scores that evaluate different aspects of the content, such as violence, adult content, or offensive language. This event can be used to track when moderation results are available, helping ensure content meets the required guidelines and standards.

Name	Type	Description
type	string	Type for the webhook event.
id	string	Unique identifier for the event.
workspace	object	Workspace information.
workspace.name	string	Name of the workspace.
workspace.id	string	Unique identifier for the workspace (e.g., “a56a1e42-65ec-4f9d-9fc1-89d24cd59348”).
status	string	Status of the media. Possible values: `"ready"`.
data	object	Data related to the media event.
-data.isModerationGenerated	boolean	Indicates if moderation results were generated (`true` / `false`).
-data.moderationResult	object	The moderation results of the media content.
-data.moderationResult.categoryScores	array	List of category scores for moderation.
-data.moderationResult.categoryScores[].category	string	The moderation category.
-data.moderationResult.categoryScores[].score	number	The score for the given category.
createdAt	string	Timestamp when the event was created (e.g., “2025-01-17T05:52:32.319576585Z”).
attempts	array	List of attempts, if any.

video.media.ai.advanced_summary.ready

Sent when an advanced summary is ready for a media asset. This event is a notification only; the summary itself isn’t included in the payload. When you receive this event, call the Get advanced summary result endpoint with the mediaId to retrieve the structured summary, including the overview, key decisions, action items, sentiment scores, and per-speaker talk time. Use this event to trigger downstream workflows once the summary is available.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.advanced_summary.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the summary job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-06-24T07:00:36.229270471Z`).

video.media.ai.attributed_transcript.ready

Sent when an attributed transcript is ready for a media asset. Use this event to know when the transcript is ready to display in a player, store in your own database, or feed into downstream analysis.

To retrieve the transcript, call the Get attributed transcript endpoint with the mediaId. The endpoint returns the speaker-attributed transcript as JSON, structured by segment with speaker labels and timestamps.

The payload also includes a signed URL with a 24-hour expiry, in case you prefer the transcript as a WebVTT file.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.attributed_transcript.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the transcript job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-06-24T06:54:41.046500969Z`).
detailMediaResponse	object	The transcript download payload.
-detailMediaResponse.transcriptSignedUrl	string	A short-lived signed URL to download the WebVTT transcript. The URL expires 24 hours after issue.

video.media.ai.scene_analysis.ready

Sent when scene analysis is ready for a media asset. This event is a notification only, and the scenes aren’t included in the payload. When you receive it, call the scene analysis Get endpoint with the mediaId to retrieve each detected shot, with its start time, end time, and description. See AI scene analysis.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.scene_analysis.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the scene analysis job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-08-12T14:58:43.399485211Z`).

video.media.ai.chapters.ready

Sent when chapter generation is ready for a media asset. This event is a notification only; the chapters aren’t included in the payload. When you receive it, call the Get chapters endpoint (GET https://api.fastpix.com/v1/ai/{mediaId}/chapters) with the mediaId to retrieve the chapter list. See Generate video chapters.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.chapters.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-08-12T14:58:43.399485211Z`).

video.media.ai.summary.ready

Sent when a summary is ready for a media asset. This event is a notification only; the summary isn’t included in the payload. When you receive it, call the Get summary endpoint (GET https://api.fastpix.com/v1/ai/{mediaId}/summary) with the mediaId to retrieve the summary. See Generate a video summary.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.summary.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-08-12T14:58:43.399485211Z`).

video.media.ai.named_entities.ready

Sent when named entity recognition is ready for a media asset. This event is a notification only; the entities aren’t included in the payload. When you receive it, call the Get named entities endpoint (GET https://api.fastpix.com/v1/ai/{mediaId}/named-entities) with the mediaId to retrieve the entities. See Extract named entities from a video.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.named_entities.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-08-12T14:58:43.399485211Z`).

video.media.ai.moderation.ready

Sent when moderation analysis is ready for a media asset. This event is a notification only; the moderation results aren’t included in the payload. When you receive it, call the Get moderation endpoint (GET https://api.fastpix.com/v1/ai/{mediaId}/moderation) with the mediaId to retrieve the category scores. See Detect NSFW content and profanity.

Field	Type	Description
type	string	The webhook event type. Always `video.media.ai.moderation.ready`.
mediaId	string	The unique identifier of the media asset, as a UUID.
workspaceId	string	The unique identifier of the workspace that owns the media, as a UUID.
status	string	The state of the job. Always `ready` for this event.
createdAt	string	The timestamp when the event was created, in ISO 8601 format (for example, `2026-08-12T14:58:43.399485211Z`).