IMimentiv
Video Emotion API

Put Video Provider Transcript

Changed on

Attach a transcript produced elsewhere (for example by a meeting provider) to a video.

The transcript is stored beside the video's own transcript and does not replace it: the analysis, speakers and every other result keep using the video's own transcript, and the attached one is read back with GET /v2/videos/{video_id}/transcript?transcript=provider. Speaker display names sent in speakers are stored with the attached transcript only; they do not rename speakers on the video.

Only one transcript can be attached per video. Sending again replaces it, whatever its source. Sending the same content again changes nothing and returns the original attached_at, so a request can be retried safely. replaced is true only when this request replaced a different transcript that was already attached.

start_ms and end_ms are on the video's own timeline; no offset is applied. Segments are stored and returned in start_ms order. At least one segment is required.

The request body is limited to 1 MiB, the transcript to 10,000 segments, and the stored content (segments and speaker names) to 640 KiB; over any limit the response is 413 and nothing is stored. The video's owner and administrators can attach a transcript. No charge is applied.

put/v2/videos/{video_id}/transcript

Request

  • Base URL
    https://api.imentiv.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://api.imentiv.ai/oauth/authorize
      Token URL: https://api.imentiv.ai/oauth/token scopes: media.write

Path parameters

video_idstring required

The unique ID of the video.

Request body

source'tldv' | 'zoom' | 'meet' | 'other' required

Where the transcript came from. Use other for any other source.

speakersobject nullable

Optional display names, keyed by a speaker label used in segments. Each name is 1-60 characters after surrounding spaces are removed.

Response

Successful Response

media_idstring required
source'tldv' | 'zoom' | 'meet' | 'other' required
segment_countinteger required
speakersobject required
attached_atstring required

When the transcript was first attached in its current form (ISO 8601, UTC).

replacedboolean required

True when this request replaced a different provider transcript that was already attached; false for a first attach and for a repeat of identical content.

Changes