IMimentiv
Image Emotion API

Upload Image

Changed on

Analyze emotions and facial expressions from image content.

Submit an image from multiple sources and receive detailed emotion analysis of all detected faces in the image.

Input Sources:

  • Cloud Storage: Dropbox or other cloud service links
  • Direct URL: Any publicly accessible image link
  • File Upload: Upload image files directly from your device

How It Works:

  1. Submit your image and receive an immediate response with an image ID
  2. Image is queued for processing (typically completes within seconds)
  3. Optionally receive a webhook notification via callback_url when complete
  4. Retrieve results using the image ID

Supported Formats: JPG, JPEG, PNG, WEBP

Credit Usage:

  • 10 credits per image
  • Enterprise plans: 5 credits per image
post/v2/images

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

Request body multipart/form-data

titlestring required

A descriptive title for your image (e.g., 'Customer Reaction' or 'Team Photo').

descriptionstring

Optional notes about the image content or context.

image_urlstring

URL to your image source (Dropbox or any direct image link). Leave empty if uploading a file instead.

callback_urlstring

Your webhook URL to receive a notification when analysis completes. Must be an https URL on a publicly reachable host.

image_filestring binary

Upload an image file directly (jpg, jpeg, png, webp). File upload takes priority over image_url.

Response

Successful Response

idstring required
titlestring required
statusstring required
media_sourcestring required
media_source_urlstring required
media_source_typestring required
user_idstring required
created_atstring nullable

Changes

  • 536bf48bb9fbRevision changes
    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security BearerAuth was added to the API

    • info

      the endpoint scheme security OAuth2Delegated was added to the API

  • b10651168511Revision changes
    • info

      the request property type was generalized from no type to string, and format from no format to binary