naftiko: 1.0.0-alpha2 info: label: Welcome to Imentiv AI description: '# Welcome to Imentiv AI Imentiv AI is an advanced Emotion AI platform that leverages deep learning to analyze human emotions across multiple media formats, including video, audio, images, and text. By interpreting facial expressions, vocal tones, and linguistic cues, it provides detailed emotional insights to support use cases such as content creation, marketing optimization, education, mental health assessments, and more. Imentiv AI offers a suite of Emotion Recognition APIs that allow developers and businesses to seamlessly integrate advanced emotion analysis into their applications, enablin' tags: - Imentiv - Ai - API created: '2026-05-06' modified: '2026-05-06' capability: consumes: - type: http namespace: imentiv-ai baseUri: https://api.example.com description: Welcome to Imentiv AI HTTP API. authentication: type: apikey in: header name: X-API-Key value: '{{IMENTIV_AI_TOKEN}}' resources: - name: v2-videos path: /v2/videos operations: - name: upload-video-v2-videos-post method: POST description: Upload Video outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos path: /v1/videos operations: - name: list-videos-v1-videos-get method: GET description: List Videos inputParameters: - name: offset_video_id in: query type: string description: The ID of the reference video from which to paginate forward/backward - name: page_size in: query type: integer description: 'Number of results to return (default: 10)' - name: direction in: query type: string description: 'Pagination direction: forward (default) or backward' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id path: /v1/videos/{video_id} operations: - name: get-video-emotion-insights-v1-videos-video-id-ge method: GET description: Get Video Emotion Insights inputParameters: - name: video_id in: path type: string required: true description: The unique ID of the video to be fetched outputRawFormat: json outputParameters: - name: result type: object value: $. - name: delete-video-v1-videos-video-id-delete method: DELETE description: Delete Video inputParameters: - name: video_id in: path type: string required: true description: The unique ID of the video to be deleted. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: reprocess-video-v1-videos-video-id-put method: PUT description: Reprocess Video inputParameters: - name: video_id in: path type: string required: true description: Unique identifier of the video to reprocess outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-videos-video-id-multimodal-analytics path: /v2/videos/{video_id}/multimodal-analytics operations: - name: get-video-multimodal-insights-v2-videos-video-id method: GET description: Get Video Multimodal Insights inputParameters: - name: video_id in: path type: string required: true description: The unique ID of the video outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-videos-video-id-emotions-average path: /v2/videos/{video_id}/emotions/average operations: - name: get-average-emotions-v2-videos-video-id-emotions method: GET description: Get Average Emotions inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video for which average emotions are to be calculated - name: face_id in: query type: integer description: Optional face ID to calculate average emotions for a specific face outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-videos-video-id-annotated-video path: /v2/videos/{video_id}/annotated_video operations: - name: get-annotated-video-v2-videos-video-id-annotated method: GET description: Get Annotated Video inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video - name: callback_url in: query type: string description: Optional callback URL to notify when annotated video generation is complete outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-valence-arousal path: /v1/videos/{video_id}/valence_arousal operations: - name: get-valence-arousal-v1-videos-video-id-valence-a method: GET description: Get Valence Arousal inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video whose emotion intensity is to be fetched outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames path: /v1/videos/{video_id}/frames operations: - name: get-multiple-frame-v1-videos-video-id-frames-get method: GET description: Get Multiple Frame inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video for which the frames to be fetched - name: start_frame in: query type: string description: The frame number from which retrieval should begin. Defaults to the start of the video if not provided. - name: length in: query type: string description: The number of frames to retrieve, starting from 'start_frame'. If omitted, all available frames will be returned. - name: face_ids in: query type: string description: Optional comma-separated list of face IDs (e.g., '1,2,3') outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames-frame-id path: /v1/videos/{video_id}/frames/{frame_id} operations: - name: get-single-frame-v1-videos-video-id-frames-frame method: GET description: Get Single Frame inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video for which the frame to be fetched. - name: frame_id in: path type: string required: true description: The unique frame ID of the frame to be fetched. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames-frame-id-dominant-emot path: /v1/videos/{video_id}/frames/{frame_id}/dominant_emotion operations: - name: retrieve-domination-emotion-for-a-specific-frame method: GET description: Retrieve Domination Emotion For A Specific Frame inputParameters: - name: video_id in: path type: string required: true description: Unique identifier of the video from which the frame’s dominant emotion is to be fetched. - name: frame_id in: path type: string required: true description: The unique id of the frame from which the dominant emotion is to be fetched. - name: face_id in: query type: string description: The id of the face whose dominant emotion is to be retrieved. If not provided, the dominant emotion for the entire frame will be returned. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames-frame-id-valence-arous path: /v1/videos/{video_id}/frames/{frame_id}/valence_arousal operations: - name: retrieve-emotion-intensity-v1-videos-video-id-fr method: GET description: Retrieve Emotion Intensity inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video for which the frame's valence, arousal, and intensity are to be fetched. - name: frame_id in: path type: string required: true description: The unique frame ID of the frame from which to fetch the valence, arousal, and intensity. - name: face_id in: query type: string description: The ID of the face whose valence, arousal, and intensity are to be retrieved. If not provided, these values for the entire frame will be returned. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames-frame-id-faces-face-id path: /v1/videos/{video_id}/frames/{frame_id}/faces/{face_id}/emotions operations: - name: update-emotion-per-frame-v1-videos-video-id-fram method: PUT description: Update Emotion Per Frame inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video. - name: frame_id in: path type: string required: true description: The unique frame ID of the frame. - name: face_id in: path type: string required: true description: The unique face ID of the face in the frame. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames-frame-id-faces-face-id path: /v1/videos/{video_id}/frames/{frame_id}/faces/{face_id}/note operations: - name: edit-face-note-v1-videos-video-id-frames-frame-i method: PUT description: Edit Face Note inputParameters: - name: video_id in: path type: string required: true description: The unique video id of the video. - name: frame_id in: path type: string required: true description: The unique id of the frame inside the video. - name: face_id in: path type: string required: true description: The unique id of the face inside the frame. Use '0' to add a note to the entire frame instead of a specific face. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-frames-faces path: /v1/videos/{video_id}/frames/faces operations: - name: update-multiple-faces-v1-videos-video-id-frames- method: PUT description: Update Multiple Faces inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video in which face ID to be changed outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-faces path: /v1/videos/{video_id}/faces operations: - name: merge-face-v1-videos-video-id-faces-put method: PUT description: Merge Face inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: delete-faces-v1-videos-video-id-faces-delete method: DELETE description: Delete Faces inputParameters: - name: video_id in: path type: string required: true description: The unique identifier of the video from which faces will be deleted. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-faces-names path: /v1/videos/{video_id}/faces/names operations: - name: update-faces-names-v1-videos-video-id-faces-name method: PUT description: Update Faces Names inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-highlights path: /v1/videos/highlights operations: - name: process-highlight-v1-videos-highlights-post method: POST description: Process Highlight outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-highlights path: /v1/videos/{video_id}/highlights operations: - name: fetch-highlight-video-v1-videos-video-id-highlig method: GET description: Fetch Highlight Video inputParameters: - name: video_id in: path type: string required: true description: The video id to get the highlight video url outputRawFormat: json outputParameters: - name: result type: object value: $. - name: update-highlight-video-v1-videos-video-id-highli method: PUT description: Update Highlight Video inputParameters: - name: video_id in: path type: string required: true description: The unique video id of the video for which the update highlight video to be edited. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-highlight-video path: /v1/videos/{video_id}/highlight_video operations: - name: download-highlight-video-v1-videos-video-id-high method: GET description: Download Highlight Video inputParameters: - name: video_id in: path type: string required: true description: The video id to download the highlight video. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-metadata path: /v1/videos/{video_id}/metadata operations: - name: edit-title-or-description-by-id-v1-videos-video- method: PUT description: Edit Title Or Description By Id inputParameters: - name: video_id in: path type: string required: true description: Provide the video ID to edit or title and description of the audio outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-videos-video-id-report path: /v1/videos/{video_id}/report operations: - name: generate-video-emotion-analysis-report-v1-videos method: POST description: Generate Video Emotion Analysis Report inputParameters: - name: video_id in: path type: string required: true description: The unique video ID of the video whose analysis report is to be generated. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: download-video-emotion-analysis-report-v1-videos method: GET description: Download Video Emotion Analysis Report inputParameters: - name: video_id in: path type: string required: true description: Provide the video ID to download analysis outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-audios path: /v2/audios operations: - name: upload-audio-v2-audios-post method: POST description: Upload Audio outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios path: /v1/audios operations: - name: list-audios-v1-audios-get method: GET description: List Audios inputParameters: - name: offset_audio_id in: query type: string description: The ID of the reference audio from which to paginate forward/backward - name: page_size in: query type: integer description: 'Number of results to return (default: 20, max: 100)' - name: direction in: query type: string description: 'Pagination direction: forward (default) or backward' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id path: /v1/audios/{audio_id} operations: - name: get-audio-emotion-insights-v1-audios-audio-id-ge method: GET description: Get Audio Emotion Insights inputParameters: - name: audio_id in: path type: string required: true description: The unique ID of the uploaded audio outputRawFormat: json outputParameters: - name: result type: object value: $. - name: reprocess-audio-v1-audios-audio-id-put method: PUT description: Reprocess Audio inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio to reprocess outputRawFormat: json outputParameters: - name: result type: object value: $. - name: delete-an-audio-v1-audios-audio-id-delete method: DELETE description: Delete An Audio inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio to be deleted outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-audios-audio-id-multimodal-analytics path: /v2/audios/{audio_id}/multimodal-analytics operations: - name: get-audio-multimodal-insights-v2-audios-audio-id method: GET description: Get Audio Multimodal Insights inputParameters: - name: audio_id in: path type: string required: true description: The unique ID of the audio outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id-segment-index path: /v1/audios/{audio_id}/{segment_index} operations: - name: delete-audio-segment-v1-audios-audio-id-segment- method: DELETE description: Delete Audio Segment inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio file - name: segment_index in: path type: integer required: true description: The index of the segment to delete (0-based indexing) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id-transcript path: /v1/audios/{audio_id}/transcript operations: - name: update-audio-transcripts-segments-v1-audios-audi method: PUT description: Update Audio Transcripts Segments inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio file outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id-speakers-names path: /v1/audios/{audio_id}/speakers/names operations: - name: update-speaker-names-v1-audios-audio-id-speakers method: PUT description: Update Speaker Names inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio file outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id-metadata path: /v1/audios/{audio_id}/metadata operations: - name: edit-title-or-description-v1-audios-audio-id-met method: PUT description: Edit Title Or Description inputParameters: - name: audio_id in: path type: string required: true description: Provide the audio ID to edit the title or description of the audio outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id-report path: /v1/audios/{audio_id}/report operations: - name: download-audio-emotion-report-v1-audios-audio-id method: GET description: Download Audio Emotion Report inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio file outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-texts path: /v2/texts operations: - name: upload-text-v2-texts-post method: POST description: Upload Text outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-texts path: /v1/texts operations: - name: list-texts-v1-texts-get method: GET description: List Texts inputParameters: - name: start_after in: query type: string description: The ID of the reference text from which to paginate forward/backward - name: page_size in: query type: integer description: 'Number of results to return (default: 10)' - name: direction in: query type: string description: 'Pagination direction: forward (default) or backward' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-texts-text-id path: /v1/texts/{text_id} operations: - name: get-text-emotion-insights-v1-texts-text-id-get method: GET description: Get Text Emotion Insights inputParameters: - name: text_id in: path type: string required: true description: The unique ID of the text. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: delete-text-v1-texts-text-id-delete method: DELETE description: Delete Text inputParameters: - name: text_id in: path type: string required: true description: The unique text ID of the text. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: reprocess-text-v1-texts-text-id-put method: PUT description: Reprocess Text inputParameters: - name: text_id in: path type: string required: true description: The unique ID of the text. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-images path: /v2/images operations: - name: upload-image-v2-images-post method: POST description: Upload Image outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-images path: /v1/images operations: - name: list-images-v1-images-get method: GET description: List Images inputParameters: - name: start_after in: query type: string description: ID of the last image from the previous page. Fetches results after this ID. - name: page_size in: query type: integer description: Number of results to return per page. The default is 10. - name: direction in: query type: string description: 'Pagination direction: ''forward'' or ''backward''. Default is ''forward''' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-images-image-id path: /v1/images/{image_id} operations: - name: get-image-emotion-analysis-v1-images-image-id-ge method: GET description: Get Image Emotion Analysis inputParameters: - name: image_id in: path type: string required: true description: Unique ID of the image to retrieve. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: delete-image-v1-images-image-id-delete method: DELETE description: Delete Image inputParameters: - name: image_id in: path type: string required: true description: Unique ID of the image outputRawFormat: json outputParameters: - name: result type: object value: $. - name: reprocess-image-v1-images-image-id-put method: PUT description: Reprocess Image inputParameters: - name: image_id in: path type: string required: true description: The unique image ID of the image. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-images-image-id-annotated-image path: /v1/images/{image_id}/annotated_image operations: - name: send-image-v1-images-image-id-annotated-image-ge method: GET description: Send Image inputParameters: - name: image_id in: path type: string required: true description: Unique ID of the image. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-images-image-id-faces-face-id-note path: /v1/images/{image_id}/faces/{face_id}/note operations: - name: add-note-to-specific-face-v1-images-image-id-fac method: PUT description: Add Note To Specific Face inputParameters: - name: image_id in: path type: string required: true description: The unique image ID of the image - name: face_id in: path type: string required: true description: Unique ID of the face within the image outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-images-image-id-metadata path: /v1/images/{image_id}/metadata operations: - name: edit-image-metadata-v1-images-image-id-metadata- method: PUT description: Edit Image Metadata inputParameters: - name: image_id in: path type: string required: true description: Provide the image ID to edit the title or description of the image outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-images-image-id-report path: /v1/images/{image_id}/report operations: - name: download-image-emotion-report-v1-images-image-id method: GET description: Download Image Emotion Report inputParameters: - name: image_id in: path type: string required: true description: Unique ID of the image outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-reports-pdf-media-id path: /v2/reports/pdf/{media_id} operations: - name: generate-pdf-report-v2-reports-pdf-media-id-get method: GET description: Generate Pdf Report inputParameters: - name: media_id in: path type: string required: true description: Unique identifier of the media - name: media_type in: query type: string required: true description: 'Type: Only ''video'' is allowed at present' - name: callback_url in: query type: string description: Callback URL for completion notification outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-texts-text-id-emotions path: /v1/texts/{text_id}/emotions operations: - name: edit-text-v1-texts-text-id-emotions-put method: PUT description: Edit Text inputParameters: - name: text_id in: path type: string required: true description: The unique text ID of the text. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-texts-text-id-report path: /v1/texts/{text_id}/report operations: - name: download-text-emotion-report-v1-texts-text-id-re method: GET description: Download Text Emotion Report inputParameters: - name: text_id in: path type: string required: true description: The unique ID of the text. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v1-audios-audio-id-transcript-replace path: /v1/audios/{audio_id}/transcript/replace operations: - name: replace-audio-transcript-v1-audios-audio-id-tran method: PUT description: Replace Audio Transcript inputParameters: - name: audio_id in: path type: string required: true description: Unique identifier of the audio file outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-media-type-media-id-ai-insights path: /v2/{media_type}/{media_id}/ai-insights operations: - name: chat-ai-insights-v2-media-type-media-id-ai-insig method: POST description: Send message to AI Insights inputParameters: - name: media_type in: path type: string required: true - name: media_id in: path type: string required: true - name: stream in: query type: boolean description: Enable SSE streaming (true) or return full JSON response (false) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: get-ai-insights-history-v2-media-type-media-id-a method: GET description: Get AI Insights conversation history inputParameters: - name: media_type in: path type: string required: true - name: media_id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-videos-video-id-speaker-face-match path: /v2/videos/{video_id}/speaker-face-match operations: - name: update-speaker-face-match-v2-videos-video-id-spe method: PUT description: Update Speaker Face Match inputParameters: - name: video_id in: path type: string required: true description: Unique identifier of the video. Video must be in 'completed' status with associated audio analysis. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: trigger-speaker-face-match-v2-videos-video-id-sp method: POST description: Trigger Speaker Face Match inputParameters: - name: video_id in: path type: string required: true description: Unique identifier of the video. Video must be in 'completed' status with associated audio. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v2-videos-video-id-personality-analyze path: /v2/videos/{video_id}/personality/analyze operations: - name: trigger-personality-analysis-v2-videos-video-id- method: POST description: Trigger Personality Analysis inputParameters: - name: video_id in: path type: string required: true description: Unique identifier of the video. Video must be in 'completed' status with detected faces. outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest port: 8080 namespace: imentiv-ai-rest description: REST adapter for Welcome to Imentiv AI. resources: - path: /v2/videos name: upload-video-v2-videos-post operations: - method: POST name: upload-video-v2-videos-post description: Upload Video call: imentiv-ai.upload-video-v2-videos-post outputParameters: - type: object mapping: $. - path: /v1/videos name: list-videos-v1-videos-get operations: - method: GET name: list-videos-v1-videos-get description: List Videos call: imentiv-ai.list-videos-v1-videos-get outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id} name: get-video-emotion-insights-v1-videos-video-id-ge operations: - method: GET name: get-video-emotion-insights-v1-videos-video-id-ge description: Get Video Emotion Insights call: imentiv-ai.get-video-emotion-insights-v1-videos-video-id-ge with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id} name: delete-video-v1-videos-video-id-delete operations: - method: DELETE name: delete-video-v1-videos-video-id-delete description: Delete Video call: imentiv-ai.delete-video-v1-videos-video-id-delete with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id} name: reprocess-video-v1-videos-video-id-put operations: - method: PUT name: reprocess-video-v1-videos-video-id-put description: Reprocess Video call: imentiv-ai.reprocess-video-v1-videos-video-id-put with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v2/videos/{video_id}/multimodal-analytics name: get-video-multimodal-insights-v2-videos-video-id operations: - method: GET name: get-video-multimodal-insights-v2-videos-video-id description: Get Video Multimodal Insights call: imentiv-ai.get-video-multimodal-insights-v2-videos-video-id with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v2/videos/{video_id}/emotions/average name: get-average-emotions-v2-videos-video-id-emotions operations: - method: GET name: get-average-emotions-v2-videos-video-id-emotions description: Get Average Emotions call: imentiv-ai.get-average-emotions-v2-videos-video-id-emotions with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v2/videos/{video_id}/annotated_video name: get-annotated-video-v2-videos-video-id-annotated operations: - method: GET name: get-annotated-video-v2-videos-video-id-annotated description: Get Annotated Video call: imentiv-ai.get-annotated-video-v2-videos-video-id-annotated with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/valence_arousal name: get-valence-arousal-v1-videos-video-id-valence-a operations: - method: GET name: get-valence-arousal-v1-videos-video-id-valence-a description: Get Valence Arousal call: imentiv-ai.get-valence-arousal-v1-videos-video-id-valence-a with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames name: get-multiple-frame-v1-videos-video-id-frames-get operations: - method: GET name: get-multiple-frame-v1-videos-video-id-frames-get description: Get Multiple Frame call: imentiv-ai.get-multiple-frame-v1-videos-video-id-frames-get with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames/{frame_id} name: get-single-frame-v1-videos-video-id-frames-frame operations: - method: GET name: get-single-frame-v1-videos-video-id-frames-frame description: Get Single Frame call: imentiv-ai.get-single-frame-v1-videos-video-id-frames-frame with: video_id: rest.video_id frame_id: rest.frame_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames/{frame_id}/dominant_emotion name: retrieve-domination-emotion-for-a-specific-frame operations: - method: GET name: retrieve-domination-emotion-for-a-specific-frame description: Retrieve Domination Emotion For A Specific Frame call: imentiv-ai.retrieve-domination-emotion-for-a-specific-frame with: video_id: rest.video_id frame_id: rest.frame_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames/{frame_id}/valence_arousal name: retrieve-emotion-intensity-v1-videos-video-id-fr operations: - method: GET name: retrieve-emotion-intensity-v1-videos-video-id-fr description: Retrieve Emotion Intensity call: imentiv-ai.retrieve-emotion-intensity-v1-videos-video-id-fr with: video_id: rest.video_id frame_id: rest.frame_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames/{frame_id}/faces/{face_id}/emotions name: update-emotion-per-frame-v1-videos-video-id-fram operations: - method: PUT name: update-emotion-per-frame-v1-videos-video-id-fram description: Update Emotion Per Frame call: imentiv-ai.update-emotion-per-frame-v1-videos-video-id-fram with: video_id: rest.video_id frame_id: rest.frame_id face_id: rest.face_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames/{frame_id}/faces/{face_id}/note name: edit-face-note-v1-videos-video-id-frames-frame-i operations: - method: PUT name: edit-face-note-v1-videos-video-id-frames-frame-i description: Edit Face Note call: imentiv-ai.edit-face-note-v1-videos-video-id-frames-frame-i with: video_id: rest.video_id frame_id: rest.frame_id face_id: rest.face_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/frames/faces name: update-multiple-faces-v1-videos-video-id-frames operations: - method: PUT name: update-multiple-faces-v1-videos-video-id-frames- description: Update Multiple Faces call: imentiv-ai.update-multiple-faces-v1-videos-video-id-frames- with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/faces name: merge-face-v1-videos-video-id-faces-put operations: - method: PUT name: merge-face-v1-videos-video-id-faces-put description: Merge Face call: imentiv-ai.merge-face-v1-videos-video-id-faces-put with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/faces name: delete-faces-v1-videos-video-id-faces-delete operations: - method: DELETE name: delete-faces-v1-videos-video-id-faces-delete description: Delete Faces call: imentiv-ai.delete-faces-v1-videos-video-id-faces-delete with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/faces/names name: update-faces-names-v1-videos-video-id-faces-name operations: - method: PUT name: update-faces-names-v1-videos-video-id-faces-name description: Update Faces Names call: imentiv-ai.update-faces-names-v1-videos-video-id-faces-name with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/highlights name: process-highlight-v1-videos-highlights-post operations: - method: POST name: process-highlight-v1-videos-highlights-post description: Process Highlight call: imentiv-ai.process-highlight-v1-videos-highlights-post outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/highlights name: fetch-highlight-video-v1-videos-video-id-highlig operations: - method: GET name: fetch-highlight-video-v1-videos-video-id-highlig description: Fetch Highlight Video call: imentiv-ai.fetch-highlight-video-v1-videos-video-id-highlig with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/highlights name: update-highlight-video-v1-videos-video-id-highli operations: - method: PUT name: update-highlight-video-v1-videos-video-id-highli description: Update Highlight Video call: imentiv-ai.update-highlight-video-v1-videos-video-id-highli with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/highlight_video name: download-highlight-video-v1-videos-video-id-high operations: - method: GET name: download-highlight-video-v1-videos-video-id-high description: Download Highlight Video call: imentiv-ai.download-highlight-video-v1-videos-video-id-high with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/metadata name: edit-title-or-description-by-id-v1-videos-video operations: - method: PUT name: edit-title-or-description-by-id-v1-videos-video- description: Edit Title Or Description By Id call: imentiv-ai.edit-title-or-description-by-id-v1-videos-video- with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/report name: generate-video-emotion-analysis-report-v1-videos operations: - method: POST name: generate-video-emotion-analysis-report-v1-videos description: Generate Video Emotion Analysis Report call: imentiv-ai.generate-video-emotion-analysis-report-v1-videos with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v1/videos/{video_id}/report name: download-video-emotion-analysis-report-v1-videos operations: - method: GET name: download-video-emotion-analysis-report-v1-videos description: Download Video Emotion Analysis Report call: imentiv-ai.download-video-emotion-analysis-report-v1-videos with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v2/audios name: upload-audio-v2-audios-post operations: - method: POST name: upload-audio-v2-audios-post description: Upload Audio call: imentiv-ai.upload-audio-v2-audios-post outputParameters: - type: object mapping: $. - path: /v1/audios name: list-audios-v1-audios-get operations: - method: GET name: list-audios-v1-audios-get description: List Audios call: imentiv-ai.list-audios-v1-audios-get outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id} name: get-audio-emotion-insights-v1-audios-audio-id-ge operations: - method: GET name: get-audio-emotion-insights-v1-audios-audio-id-ge description: Get Audio Emotion Insights call: imentiv-ai.get-audio-emotion-insights-v1-audios-audio-id-ge with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id} name: reprocess-audio-v1-audios-audio-id-put operations: - method: PUT name: reprocess-audio-v1-audios-audio-id-put description: Reprocess Audio call: imentiv-ai.reprocess-audio-v1-audios-audio-id-put with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id} name: delete-an-audio-v1-audios-audio-id-delete operations: - method: DELETE name: delete-an-audio-v1-audios-audio-id-delete description: Delete An Audio call: imentiv-ai.delete-an-audio-v1-audios-audio-id-delete with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v2/audios/{audio_id}/multimodal-analytics name: get-audio-multimodal-insights-v2-audios-audio-id operations: - method: GET name: get-audio-multimodal-insights-v2-audios-audio-id description: Get Audio Multimodal Insights call: imentiv-ai.get-audio-multimodal-insights-v2-audios-audio-id with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id}/{segment_index} name: delete-audio-segment-v1-audios-audio-id-segment operations: - method: DELETE name: delete-audio-segment-v1-audios-audio-id-segment- description: Delete Audio Segment call: imentiv-ai.delete-audio-segment-v1-audios-audio-id-segment- with: audio_id: rest.audio_id segment_index: rest.segment_index outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id}/transcript name: update-audio-transcripts-segments-v1-audios-audi operations: - method: PUT name: update-audio-transcripts-segments-v1-audios-audi description: Update Audio Transcripts Segments call: imentiv-ai.update-audio-transcripts-segments-v1-audios-audi with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id}/speakers/names name: update-speaker-names-v1-audios-audio-id-speakers operations: - method: PUT name: update-speaker-names-v1-audios-audio-id-speakers description: Update Speaker Names call: imentiv-ai.update-speaker-names-v1-audios-audio-id-speakers with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id}/metadata name: edit-title-or-description-v1-audios-audio-id-met operations: - method: PUT name: edit-title-or-description-v1-audios-audio-id-met description: Edit Title Or Description call: imentiv-ai.edit-title-or-description-v1-audios-audio-id-met with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id}/report name: download-audio-emotion-report-v1-audios-audio-id operations: - method: GET name: download-audio-emotion-report-v1-audios-audio-id description: Download Audio Emotion Report call: imentiv-ai.download-audio-emotion-report-v1-audios-audio-id with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v2/texts name: upload-text-v2-texts-post operations: - method: POST name: upload-text-v2-texts-post description: Upload Text call: imentiv-ai.upload-text-v2-texts-post outputParameters: - type: object mapping: $. - path: /v1/texts name: list-texts-v1-texts-get operations: - method: GET name: list-texts-v1-texts-get description: List Texts call: imentiv-ai.list-texts-v1-texts-get outputParameters: - type: object mapping: $. - path: /v1/texts/{text_id} name: get-text-emotion-insights-v1-texts-text-id-get operations: - method: GET name: get-text-emotion-insights-v1-texts-text-id-get description: Get Text Emotion Insights call: imentiv-ai.get-text-emotion-insights-v1-texts-text-id-get with: text_id: rest.text_id outputParameters: - type: object mapping: $. - path: /v1/texts/{text_id} name: delete-text-v1-texts-text-id-delete operations: - method: DELETE name: delete-text-v1-texts-text-id-delete description: Delete Text call: imentiv-ai.delete-text-v1-texts-text-id-delete with: text_id: rest.text_id outputParameters: - type: object mapping: $. - path: /v1/texts/{text_id} name: reprocess-text-v1-texts-text-id-put operations: - method: PUT name: reprocess-text-v1-texts-text-id-put description: Reprocess Text call: imentiv-ai.reprocess-text-v1-texts-text-id-put with: text_id: rest.text_id outputParameters: - type: object mapping: $. - path: /v2/images name: upload-image-v2-images-post operations: - method: POST name: upload-image-v2-images-post description: Upload Image call: imentiv-ai.upload-image-v2-images-post outputParameters: - type: object mapping: $. - path: /v1/images name: list-images-v1-images-get operations: - method: GET name: list-images-v1-images-get description: List Images call: imentiv-ai.list-images-v1-images-get outputParameters: - type: object mapping: $. - path: /v1/images/{image_id} name: get-image-emotion-analysis-v1-images-image-id-ge operations: - method: GET name: get-image-emotion-analysis-v1-images-image-id-ge description: Get Image Emotion Analysis call: imentiv-ai.get-image-emotion-analysis-v1-images-image-id-ge with: image_id: rest.image_id outputParameters: - type: object mapping: $. - path: /v1/images/{image_id} name: delete-image-v1-images-image-id-delete operations: - method: DELETE name: delete-image-v1-images-image-id-delete description: Delete Image call: imentiv-ai.delete-image-v1-images-image-id-delete with: image_id: rest.image_id outputParameters: - type: object mapping: $. - path: /v1/images/{image_id} name: reprocess-image-v1-images-image-id-put operations: - method: PUT name: reprocess-image-v1-images-image-id-put description: Reprocess Image call: imentiv-ai.reprocess-image-v1-images-image-id-put with: image_id: rest.image_id outputParameters: - type: object mapping: $. - path: /v1/images/{image_id}/annotated_image name: send-image-v1-images-image-id-annotated-image-ge operations: - method: GET name: send-image-v1-images-image-id-annotated-image-ge description: Send Image call: imentiv-ai.send-image-v1-images-image-id-annotated-image-ge with: image_id: rest.image_id outputParameters: - type: object mapping: $. - path: /v1/images/{image_id}/faces/{face_id}/note name: add-note-to-specific-face-v1-images-image-id-fac operations: - method: PUT name: add-note-to-specific-face-v1-images-image-id-fac description: Add Note To Specific Face call: imentiv-ai.add-note-to-specific-face-v1-images-image-id-fac with: image_id: rest.image_id face_id: rest.face_id outputParameters: - type: object mapping: $. - path: /v1/images/{image_id}/metadata name: edit-image-metadata-v1-images-image-id-metadata operations: - method: PUT name: edit-image-metadata-v1-images-image-id-metadata- description: Edit Image Metadata call: imentiv-ai.edit-image-metadata-v1-images-image-id-metadata- with: image_id: rest.image_id outputParameters: - type: object mapping: $. - path: /v1/images/{image_id}/report name: download-image-emotion-report-v1-images-image-id operations: - method: GET name: download-image-emotion-report-v1-images-image-id description: Download Image Emotion Report call: imentiv-ai.download-image-emotion-report-v1-images-image-id with: image_id: rest.image_id outputParameters: - type: object mapping: $. - path: /v2/reports/pdf/{media_id} name: generate-pdf-report-v2-reports-pdf-media-id-get operations: - method: GET name: generate-pdf-report-v2-reports-pdf-media-id-get description: Generate Pdf Report call: imentiv-ai.generate-pdf-report-v2-reports-pdf-media-id-get with: media_id: rest.media_id outputParameters: - type: object mapping: $. - path: /v1/texts/{text_id}/emotions name: edit-text-v1-texts-text-id-emotions-put operations: - method: PUT name: edit-text-v1-texts-text-id-emotions-put description: Edit Text call: imentiv-ai.edit-text-v1-texts-text-id-emotions-put with: text_id: rest.text_id outputParameters: - type: object mapping: $. - path: /v1/texts/{text_id}/report name: download-text-emotion-report-v1-texts-text-id-re operations: - method: GET name: download-text-emotion-report-v1-texts-text-id-re description: Download Text Emotion Report call: imentiv-ai.download-text-emotion-report-v1-texts-text-id-re with: text_id: rest.text_id outputParameters: - type: object mapping: $. - path: /v1/audios/{audio_id}/transcript/replace name: replace-audio-transcript-v1-audios-audio-id-tran operations: - method: PUT name: replace-audio-transcript-v1-audios-audio-id-tran description: Replace Audio Transcript call: imentiv-ai.replace-audio-transcript-v1-audios-audio-id-tran with: audio_id: rest.audio_id outputParameters: - type: object mapping: $. - path: /v2/{media_type}/{media_id}/ai-insights name: chat-ai-insights-v2-media-type-media-id-ai-insig operations: - method: POST name: chat-ai-insights-v2-media-type-media-id-ai-insig description: Send message to AI Insights call: imentiv-ai.chat-ai-insights-v2-media-type-media-id-ai-insig with: media_type: rest.media_type media_id: rest.media_id outputParameters: - type: object mapping: $. - path: /v2/{media_type}/{media_id}/ai-insights name: get-ai-insights-history-v2-media-type-media-id-a operations: - method: GET name: get-ai-insights-history-v2-media-type-media-id-a description: Get AI Insights conversation history call: imentiv-ai.get-ai-insights-history-v2-media-type-media-id-a with: media_type: rest.media_type media_id: rest.media_id outputParameters: - type: object mapping: $. - path: /v2/videos/{video_id}/speaker-face-match name: update-speaker-face-match-v2-videos-video-id-spe operations: - method: PUT name: update-speaker-face-match-v2-videos-video-id-spe description: Update Speaker Face Match call: imentiv-ai.update-speaker-face-match-v2-videos-video-id-spe with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v2/videos/{video_id}/speaker-face-match name: trigger-speaker-face-match-v2-videos-video-id-sp operations: - method: POST name: trigger-speaker-face-match-v2-videos-video-id-sp description: Trigger Speaker Face Match call: imentiv-ai.trigger-speaker-face-match-v2-videos-video-id-sp with: video_id: rest.video_id outputParameters: - type: object mapping: $. - path: /v2/videos/{video_id}/personality/analyze name: trigger-personality-analysis-v2-videos-video-id operations: - method: POST name: trigger-personality-analysis-v2-videos-video-id- description: Trigger Personality Analysis call: imentiv-ai.trigger-personality-analysis-v2-videos-video-id- with: video_id: rest.video_id outputParameters: - type: object mapping: $. - type: mcp port: 9090 namespace: imentiv-ai-mcp transport: http description: MCP adapter for Welcome to Imentiv AI for AI agent use. tools: - name: upload-video-v2-videos-post description: Upload Video hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.upload-video-v2-videos-post outputParameters: - type: object mapping: $. - name: list-videos-v1-videos-get description: List Videos hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.list-videos-v1-videos-get with: offset_video_id: tools.offset_video_id page_size: tools.page_size direction: tools.direction inputParameters: - name: offset_video_id type: string description: The ID of the reference video from which to paginate forward/backward - name: page_size type: integer description: 'Number of results to return (default: 10)' - name: direction type: string description: 'Pagination direction: forward (default) or backward' outputParameters: - type: object mapping: $. - name: get-video-emotion-insights-v1-videos-video-id-ge description: Get Video Emotion Insights hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-video-emotion-insights-v1-videos-video-id-ge with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique ID of the video to be fetched required: true outputParameters: - type: object mapping: $. - name: delete-video-v1-videos-video-id-delete description: Delete Video hints: readOnly: false destructive: true idempotent: true call: imentiv-ai.delete-video-v1-videos-video-id-delete with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique ID of the video to be deleted. required: true outputParameters: - type: object mapping: $. - name: reprocess-video-v1-videos-video-id-put description: Reprocess Video hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.reprocess-video-v1-videos-video-id-put with: video_id: tools.video_id inputParameters: - name: video_id type: string description: Unique identifier of the video to reprocess required: true outputParameters: - type: object mapping: $. - name: get-video-multimodal-insights-v2-videos-video-id description: Get Video Multimodal Insights hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-video-multimodal-insights-v2-videos-video-id with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique ID of the video required: true outputParameters: - type: object mapping: $. - name: get-average-emotions-v2-videos-video-id-emotions description: Get Average Emotions hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-average-emotions-v2-videos-video-id-emotions with: video_id: tools.video_id face_id: tools.face_id inputParameters: - name: video_id type: string description: The unique video ID of the video for which average emotions are to be calculated required: true - name: face_id type: integer description: Optional face ID to calculate average emotions for a specific face outputParameters: - type: object mapping: $. - name: get-annotated-video-v2-videos-video-id-annotated description: Get Annotated Video hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-annotated-video-v2-videos-video-id-annotated with: video_id: tools.video_id callback_url: tools.callback_url inputParameters: - name: video_id type: string description: The unique video ID of the video required: true - name: callback_url type: string description: Optional callback URL to notify when annotated video generation is complete outputParameters: - type: object mapping: $. - name: get-valence-arousal-v1-videos-video-id-valence-a description: Get Valence Arousal hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-valence-arousal-v1-videos-video-id-valence-a with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique video ID of the video whose emotion intensity is to be fetched required: true outputParameters: - type: object mapping: $. - name: get-multiple-frame-v1-videos-video-id-frames-get description: Get Multiple Frame hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-multiple-frame-v1-videos-video-id-frames-get with: video_id: tools.video_id start_frame: tools.start_frame length: tools.length face_ids: tools.face_ids inputParameters: - name: video_id type: string description: The unique video ID of the video for which the frames to be fetched required: true - name: start_frame type: string description: The frame number from which retrieval should begin. Defaults to the start of the video if not provided. - name: length type: string description: The number of frames to retrieve, starting from 'start_frame'. If omitted, all available frames will be returned. - name: face_ids type: string description: Optional comma-separated list of face IDs (e.g., '1,2,3') outputParameters: - type: object mapping: $. - name: get-single-frame-v1-videos-video-id-frames-frame description: Get Single Frame hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-single-frame-v1-videos-video-id-frames-frame with: video_id: tools.video_id frame_id: tools.frame_id inputParameters: - name: video_id type: string description: The unique video ID of the video for which the frame to be fetched. required: true - name: frame_id type: string description: The unique frame ID of the frame to be fetched. required: true outputParameters: - type: object mapping: $. - name: retrieve-domination-emotion-for-a-specific-frame description: Retrieve Domination Emotion For A Specific Frame hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.retrieve-domination-emotion-for-a-specific-frame with: video_id: tools.video_id frame_id: tools.frame_id face_id: tools.face_id inputParameters: - name: video_id type: string description: Unique identifier of the video from which the frame’s dominant emotion is to be fetched. required: true - name: frame_id type: string description: The unique id of the frame from which the dominant emotion is to be fetched. required: true - name: face_id type: string description: The id of the face whose dominant emotion is to be retrieved. If not provided, the dominant emotion for the entire frame will be returned. outputParameters: - type: object mapping: $. - name: retrieve-emotion-intensity-v1-videos-video-id-fr description: Retrieve Emotion Intensity hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.retrieve-emotion-intensity-v1-videos-video-id-fr with: video_id: tools.video_id frame_id: tools.frame_id face_id: tools.face_id inputParameters: - name: video_id type: string description: The unique video ID of the video for which the frame's valence, arousal, and intensity are to be fetched. required: true - name: frame_id type: string description: The unique frame ID of the frame from which to fetch the valence, arousal, and intensity. required: true - name: face_id type: string description: The ID of the face whose valence, arousal, and intensity are to be retrieved. If not provided, these values for the entire frame will be returned. outputParameters: - type: object mapping: $. - name: update-emotion-per-frame-v1-videos-video-id-fram description: Update Emotion Per Frame hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-emotion-per-frame-v1-videos-video-id-fram with: video_id: tools.video_id frame_id: tools.frame_id face_id: tools.face_id inputParameters: - name: video_id type: string description: The unique video ID of the video. required: true - name: frame_id type: string description: The unique frame ID of the frame. required: true - name: face_id type: string description: The unique face ID of the face in the frame. required: true outputParameters: - type: object mapping: $. - name: edit-face-note-v1-videos-video-id-frames-frame-i description: Edit Face Note hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.edit-face-note-v1-videos-video-id-frames-frame-i with: video_id: tools.video_id frame_id: tools.frame_id face_id: tools.face_id inputParameters: - name: video_id type: string description: The unique video id of the video. required: true - name: frame_id type: string description: The unique id of the frame inside the video. required: true - name: face_id type: string description: The unique id of the face inside the frame. Use '0' to add a note to the entire frame instead of a specific face. required: true outputParameters: - type: object mapping: $. - name: update-multiple-faces-v1-videos-video-id-frames- description: Update Multiple Faces hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-multiple-faces-v1-videos-video-id-frames- with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique video ID of the video in which face ID to be changed required: true outputParameters: - type: object mapping: $. - name: merge-face-v1-videos-video-id-faces-put description: Merge Face hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.merge-face-v1-videos-video-id-faces-put with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique video ID of the video. required: true outputParameters: - type: object mapping: $. - name: delete-faces-v1-videos-video-id-faces-delete description: Delete Faces hints: readOnly: false destructive: true idempotent: true call: imentiv-ai.delete-faces-v1-videos-video-id-faces-delete with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique identifier of the video from which faces will be deleted. required: true outputParameters: - type: object mapping: $. - name: update-faces-names-v1-videos-video-id-faces-name description: Update Faces Names hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-faces-names-v1-videos-video-id-faces-name with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique video ID of the video. required: true outputParameters: - type: object mapping: $. - name: process-highlight-v1-videos-highlights-post description: Process Highlight hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.process-highlight-v1-videos-highlights-post outputParameters: - type: object mapping: $. - name: fetch-highlight-video-v1-videos-video-id-highlig description: Fetch Highlight Video hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.fetch-highlight-video-v1-videos-video-id-highlig with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The video id to get the highlight video url required: true outputParameters: - type: object mapping: $. - name: update-highlight-video-v1-videos-video-id-highli description: Update Highlight Video hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-highlight-video-v1-videos-video-id-highli with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique video id of the video for which the update highlight video to be edited. required: true outputParameters: - type: object mapping: $. - name: download-highlight-video-v1-videos-video-id-high description: Download Highlight Video hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.download-highlight-video-v1-videos-video-id-high with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The video id to download the highlight video. required: true outputParameters: - type: object mapping: $. - name: edit-title-or-description-by-id-v1-videos-video- description: Edit Title Or Description By Id hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.edit-title-or-description-by-id-v1-videos-video- with: video_id: tools.video_id inputParameters: - name: video_id type: string description: Provide the video ID to edit or title and description of the audio required: true outputParameters: - type: object mapping: $. - name: generate-video-emotion-analysis-report-v1-videos description: Generate Video Emotion Analysis Report hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.generate-video-emotion-analysis-report-v1-videos with: video_id: tools.video_id inputParameters: - name: video_id type: string description: The unique video ID of the video whose analysis report is to be generated. required: true outputParameters: - type: object mapping: $. - name: download-video-emotion-analysis-report-v1-videos description: Download Video Emotion Analysis Report hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.download-video-emotion-analysis-report-v1-videos with: video_id: tools.video_id inputParameters: - name: video_id type: string description: Provide the video ID to download analysis required: true outputParameters: - type: object mapping: $. - name: upload-audio-v2-audios-post description: Upload Audio hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.upload-audio-v2-audios-post outputParameters: - type: object mapping: $. - name: list-audios-v1-audios-get description: List Audios hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.list-audios-v1-audios-get with: offset_audio_id: tools.offset_audio_id page_size: tools.page_size direction: tools.direction inputParameters: - name: offset_audio_id type: string description: The ID of the reference audio from which to paginate forward/backward - name: page_size type: integer description: 'Number of results to return (default: 20, max: 100)' - name: direction type: string description: 'Pagination direction: forward (default) or backward' outputParameters: - type: object mapping: $. - name: get-audio-emotion-insights-v1-audios-audio-id-ge description: Get Audio Emotion Insights hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-audio-emotion-insights-v1-audios-audio-id-ge with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: The unique ID of the uploaded audio required: true outputParameters: - type: object mapping: $. - name: reprocess-audio-v1-audios-audio-id-put description: Reprocess Audio hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.reprocess-audio-v1-audios-audio-id-put with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Unique identifier of the audio to reprocess required: true outputParameters: - type: object mapping: $. - name: delete-an-audio-v1-audios-audio-id-delete description: Delete An Audio hints: readOnly: false destructive: true idempotent: true call: imentiv-ai.delete-an-audio-v1-audios-audio-id-delete with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Unique identifier of the audio to be deleted required: true outputParameters: - type: object mapping: $. - name: get-audio-multimodal-insights-v2-audios-audio-id description: Get Audio Multimodal Insights hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-audio-multimodal-insights-v2-audios-audio-id with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: The unique ID of the audio required: true outputParameters: - type: object mapping: $. - name: delete-audio-segment-v1-audios-audio-id-segment- description: Delete Audio Segment hints: readOnly: false destructive: true idempotent: true call: imentiv-ai.delete-audio-segment-v1-audios-audio-id-segment- with: audio_id: tools.audio_id segment_index: tools.segment_index inputParameters: - name: audio_id type: string description: Unique identifier of the audio file required: true - name: segment_index type: integer description: The index of the segment to delete (0-based indexing) required: true outputParameters: - type: object mapping: $. - name: update-audio-transcripts-segments-v1-audios-audi description: Update Audio Transcripts Segments hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-audio-transcripts-segments-v1-audios-audi with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Unique identifier of the audio file required: true outputParameters: - type: object mapping: $. - name: update-speaker-names-v1-audios-audio-id-speakers description: Update Speaker Names hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-speaker-names-v1-audios-audio-id-speakers with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Unique identifier of the audio file required: true outputParameters: - type: object mapping: $. - name: edit-title-or-description-v1-audios-audio-id-met description: Edit Title Or Description hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.edit-title-or-description-v1-audios-audio-id-met with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Provide the audio ID to edit the title or description of the audio required: true outputParameters: - type: object mapping: $. - name: download-audio-emotion-report-v1-audios-audio-id description: Download Audio Emotion Report hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.download-audio-emotion-report-v1-audios-audio-id with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Unique identifier of the audio file required: true outputParameters: - type: object mapping: $. - name: upload-text-v2-texts-post description: Upload Text hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.upload-text-v2-texts-post outputParameters: - type: object mapping: $. - name: list-texts-v1-texts-get description: List Texts hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.list-texts-v1-texts-get with: start_after: tools.start_after page_size: tools.page_size direction: tools.direction inputParameters: - name: start_after type: string description: The ID of the reference text from which to paginate forward/backward - name: page_size type: integer description: 'Number of results to return (default: 10)' - name: direction type: string description: 'Pagination direction: forward (default) or backward' outputParameters: - type: object mapping: $. - name: get-text-emotion-insights-v1-texts-text-id-get description: Get Text Emotion Insights hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-text-emotion-insights-v1-texts-text-id-get with: text_id: tools.text_id inputParameters: - name: text_id type: string description: The unique ID of the text. required: true outputParameters: - type: object mapping: $. - name: delete-text-v1-texts-text-id-delete description: Delete Text hints: readOnly: false destructive: true idempotent: true call: imentiv-ai.delete-text-v1-texts-text-id-delete with: text_id: tools.text_id inputParameters: - name: text_id type: string description: The unique text ID of the text. required: true outputParameters: - type: object mapping: $. - name: reprocess-text-v1-texts-text-id-put description: Reprocess Text hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.reprocess-text-v1-texts-text-id-put with: text_id: tools.text_id inputParameters: - name: text_id type: string description: The unique ID of the text. required: true outputParameters: - type: object mapping: $. - name: upload-image-v2-images-post description: Upload Image hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.upload-image-v2-images-post outputParameters: - type: object mapping: $. - name: list-images-v1-images-get description: List Images hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.list-images-v1-images-get with: start_after: tools.start_after page_size: tools.page_size direction: tools.direction inputParameters: - name: start_after type: string description: ID of the last image from the previous page. Fetches results after this ID. - name: page_size type: integer description: Number of results to return per page. The default is 10. - name: direction type: string description: 'Pagination direction: ''forward'' or ''backward''. Default is ''forward''' outputParameters: - type: object mapping: $. - name: get-image-emotion-analysis-v1-images-image-id-ge description: Get Image Emotion Analysis hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-image-emotion-analysis-v1-images-image-id-ge with: image_id: tools.image_id inputParameters: - name: image_id type: string description: Unique ID of the image to retrieve. required: true outputParameters: - type: object mapping: $. - name: delete-image-v1-images-image-id-delete description: Delete Image hints: readOnly: false destructive: true idempotent: true call: imentiv-ai.delete-image-v1-images-image-id-delete with: image_id: tools.image_id inputParameters: - name: image_id type: string description: Unique ID of the image required: true outputParameters: - type: object mapping: $. - name: reprocess-image-v1-images-image-id-put description: Reprocess Image hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.reprocess-image-v1-images-image-id-put with: image_id: tools.image_id inputParameters: - name: image_id type: string description: The unique image ID of the image. required: true outputParameters: - type: object mapping: $. - name: send-image-v1-images-image-id-annotated-image-ge description: Send Image hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.send-image-v1-images-image-id-annotated-image-ge with: image_id: tools.image_id inputParameters: - name: image_id type: string description: Unique ID of the image. required: true outputParameters: - type: object mapping: $. - name: add-note-to-specific-face-v1-images-image-id-fac description: Add Note To Specific Face hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.add-note-to-specific-face-v1-images-image-id-fac with: image_id: tools.image_id face_id: tools.face_id inputParameters: - name: image_id type: string description: The unique image ID of the image required: true - name: face_id type: string description: Unique ID of the face within the image required: true outputParameters: - type: object mapping: $. - name: edit-image-metadata-v1-images-image-id-metadata- description: Edit Image Metadata hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.edit-image-metadata-v1-images-image-id-metadata- with: image_id: tools.image_id inputParameters: - name: image_id type: string description: Provide the image ID to edit the title or description of the image required: true outputParameters: - type: object mapping: $. - name: download-image-emotion-report-v1-images-image-id description: Download Image Emotion Report hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.download-image-emotion-report-v1-images-image-id with: image_id: tools.image_id inputParameters: - name: image_id type: string description: Unique ID of the image required: true outputParameters: - type: object mapping: $. - name: generate-pdf-report-v2-reports-pdf-media-id-get description: Generate Pdf Report hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.generate-pdf-report-v2-reports-pdf-media-id-get with: media_id: tools.media_id media_type: tools.media_type callback_url: tools.callback_url inputParameters: - name: media_id type: string description: Unique identifier of the media required: true - name: media_type type: string description: 'Type: Only ''video'' is allowed at present' required: true - name: callback_url type: string description: Callback URL for completion notification outputParameters: - type: object mapping: $. - name: edit-text-v1-texts-text-id-emotions-put description: Edit Text hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.edit-text-v1-texts-text-id-emotions-put with: text_id: tools.text_id inputParameters: - name: text_id type: string description: The unique text ID of the text. required: true outputParameters: - type: object mapping: $. - name: download-text-emotion-report-v1-texts-text-id-re description: Download Text Emotion Report hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.download-text-emotion-report-v1-texts-text-id-re with: text_id: tools.text_id inputParameters: - name: text_id type: string description: The unique ID of the text. required: true outputParameters: - type: object mapping: $. - name: replace-audio-transcript-v1-audios-audio-id-tran description: Replace Audio Transcript hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.replace-audio-transcript-v1-audios-audio-id-tran with: audio_id: tools.audio_id inputParameters: - name: audio_id type: string description: Unique identifier of the audio file required: true outputParameters: - type: object mapping: $. - name: chat-ai-insights-v2-media-type-media-id-ai-insig description: Send message to AI Insights hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.chat-ai-insights-v2-media-type-media-id-ai-insig with: media_type: tools.media_type media_id: tools.media_id stream: tools.stream inputParameters: - name: media_type type: string description: media_type required: true - name: media_id type: string description: media_id required: true - name: stream type: boolean description: Enable SSE streaming (true) or return full JSON response (false) outputParameters: - type: object mapping: $. - name: get-ai-insights-history-v2-media-type-media-id-a description: Get AI Insights conversation history hints: readOnly: true destructive: false idempotent: true call: imentiv-ai.get-ai-insights-history-v2-media-type-media-id-a with: media_type: tools.media_type media_id: tools.media_id inputParameters: - name: media_type type: string description: media_type required: true - name: media_id type: string description: media_id required: true outputParameters: - type: object mapping: $. - name: update-speaker-face-match-v2-videos-video-id-spe description: Update Speaker Face Match hints: readOnly: false destructive: false idempotent: true call: imentiv-ai.update-speaker-face-match-v2-videos-video-id-spe with: video_id: tools.video_id inputParameters: - name: video_id type: string description: Unique identifier of the video. Video must be in 'completed' status with associated audio analysis. required: true outputParameters: - type: object mapping: $. - name: trigger-speaker-face-match-v2-videos-video-id-sp description: Trigger Speaker Face Match hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.trigger-speaker-face-match-v2-videos-video-id-sp with: video_id: tools.video_id inputParameters: - name: video_id type: string description: Unique identifier of the video. Video must be in 'completed' status with associated audio. required: true outputParameters: - type: object mapping: $. - name: trigger-personality-analysis-v2-videos-video-id- description: Trigger Personality Analysis hints: readOnly: false destructive: false idempotent: false call: imentiv-ai.trigger-personality-analysis-v2-videos-video-id- with: video_id: tools.video_id inputParameters: - name: video_id type: string description: Unique identifier of the video. Video must be in 'completed' status with detected faces. required: true outputParameters: - type: object mapping: $. binds: - namespace: env keys: IMENTIV_AI_TOKEN: IMENTIV_AI_TOKEN