action clarify_post_v1_bundles_bundle_id_insights {
label: "Request an insight to be run"
description: "Request an insight to be run on a bundle. Note that most insights are set to automatically run on all bundles so you commonly won't need to call this endpoint except to request transcripts. To configure which insights are automatically run for an app, visit the Clarify Developer Portal.
Insights that are not configured to autorun can be requested to run on an individual bundle using this endpoint. The following insights can be requested:
transcript_r9 - High-accuracy transcript of the speech in audio media.
Transcripts will produced on the mixed audio of all tracks in the bundle and are charged per minute (rounded up for partial minutes), based on the duration of the longest track. If the request has already been made, this method has no effect other than to return the existing insight.
Transcripts will typically take about 48 hours. When the transcript is ready, an InsightNotification webhook will be POSTed to the bundle notify_url.
For more information see Human Transcripts Quick Start.
captions_r9 - High-accuracy captions of the speech in video media.
Captions will be generated on the first track in the bundle. and are charged per minute (rounded up for partial minutes), based on the duration of the media. See the pricing page. If the request has already been made, this method has no effect other than to return the existing insight.
Captions will typically take about 72 hours. When the captions are ready, an InsightNotification webhook will be POSTed to the bundle notify_url.
For more information see Captions Quick Start.
spoken_keywords - Spoken words of interest found in audio media. Note: Normally spoken_keywords is set to autorun so you do not need to run it explicitly.
spoken_topics - Topics spoken about in the audio media."
provider: clarify
method: POST
path: "/v1/bundles/{bundle_id}/insights"
encoding: json
input: {
type: "object"
properties: {
bundle_id: {
type: "string"
}
}
required: ["bundle_id"]
additionalProperties: false
}
output: {
type: "object"
additionalProperties: true
}
}