IMimentiv
Video Emotion API

Get Video Face Image Url Route

Changed on

Get a short-lived URL for a face's image.

The returned url serves the stored image of one detected face, ready to use as an image source. It is short-lived: request a new one when expires_at passes or when a request made with it is refused, and do not store or share it. A face's image field in the video details is a stored reference, not guaranteed to be readable; this endpoint is how to show it.

Access Control: the same as the video details. The owner and admins can always get a face image URL. While a video is shared, or is a sample, anyone can, so sharing a video lets anyone with its link see its faces.

Errors:

  • 401: not authorized to access this video
  • 404: video or face not found
  • 409 media_not_stored: the face has no stored image (for example, a face added manually, or one whose image is not ready yet), or its image could not be looked up just now; retrying may succeed
  • 503 media_storage_unavailable: the URL could not be issued; try again shortly
get/v2/videos/{video_id}/faces/{face_id}/image-url

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.read

Path parameters

video_idstring required

The unique ID of the video.

face_idinteger required

The ID of the face within the video.

Response

Successful Response

urlstring required

Signed URL of the face image, for use as an image source. Short-lived: request a new one when expires_at passes or a request with it is refused. Do not store or share it.

expires_atstring required

RFC 3339 UTC instant at which url stops working, e.g. 2026-09-28T12:30:00Z.

content_typestring required

The image's content type, e.g. image/jpeg.

Changes