Video Emotion API

Trim Video Endpoint

Changed on

Crop an uploaded video by trimming time off the beginning and/or the end.

On a processed video this drops the cut-out portion's faces, speakers, transcript, and facial/audio/text emotion data by re-analyzing only the kept window (timestamps re-based to the new start). The video re-enters processing; poll the status endpoint for completion.

put/v1/videos/{video_id}/trim

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

Path parameters

video_idstring required

Unique identifier of the video to crop

Request body application/x-www-form-urlencoded

start_millisinteger required

Kept-window start in ms (seconds trimmed off the beginning).

end_millisinteger required

Kept-window end in ms (> start_millis, <= video duration).

callback_urlstring nullable

Optional callback url notified when reprocessing completes. Must be an https URL on a publicly reachable host.

Response

Successful Response

idstring required
statusstring required
messagestring required

Changes

    • breaking

      the response's property type changed from array to string for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

    • info

      endpoint added