Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Imentiv AI Image Emotion API API

The Image Emotion Recognition API by Imentiv analyzes human facial expressions in an image and returns the detected emotions. It can detect multiple faces and evaluate each face's emotional state, providing detailed emotional labels such as happy, sad, angry, neutral, surprise, disgust, fear, and contempt.

Imentiv AI Image Emotion API API is one of 6 APIs that Imentiv AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Image Emotion API. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 9 operations across 7 paths, and defines 13 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against the base URL https://api.imentiv.ai.

9 operations 7 paths 13 schemas 1 DELETE4 GET1 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.imentiv.ai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Imentiv AI Image Emotion API API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-Key (APIKeyHeader).

Paths & Operations 9

Across 7 paths, the API surfaces 9 operations — 1 DELETE, 4 GET, 1 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Image Emotion API 9

The Image Emotion Recognition API by Imentiv analyzes human facial expressions in an image and returns the detected emotions. It can detect multiple faces and evaluate each face's…

POST
/v2/images
Upload Image
upload_image_v2_images_post body → 200422
GET
/v1/images
List Images
list_images_v1_images_get 3 params → 200422
GET
/v1/images/{image_id}
Get Image Emotion Analysis
get_image_emotion_analysis_v1_images__image_id__get 1 param → 200422
DELETE
/v1/images/{image_id}
Delete Image
delete_image_v1_images__image_id__delete 1 param → 200422
PUT
/v1/images/{image_id}
Reprocess Image
reprocess_image_v1_images__image_id__put 1 param body → 200422
GET
/v1/images/{image_id}/annotated_image
Send Image
send_image_v1_images__image_id__annotated_image_get 1 param → 200422
PUT
/v1/images/{image_id}/faces/{face_id}/note
Add Note To Specific Face
add_note_to_specific_face_v1_images__image_id__faces__face_id__note_put 2 params body → 200422
PUT
/v1/images/{image_id}/metadata
Edit Image Metadata
edit_image_metadata_v1_images__image_id__metadata_put 1 param body → 200422
GET
/v1/images/{image_id}/report
Download Image Emotion Report
download_image_emotion_report_v1_images__image_id__report_get 1 param → 200422

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are ImageDBResponse (11 properties), ImageEmotionResponseV2 (8 properties), Body_upload_image_v2_images_post (5 properties), Body_edit_image_metadata_v1_images__image_id__metadata_put (4 properties). Each schema is shown below with its type and property counts.

ImageEditResponse
object
Model for editing image metadata. Attributes: title (str): Updated title. description (str): Updated description.
2 properties
ImageDeleteResponse
object
Response returned after deleting an image analysis result.
2 properties 2 required
Body_edit_image_metadata_v1_images__image_id__metadata_put
object
4 properties
HTTPValidationError
object
1 property
ValidationError
object
3 properties 3 required
PaginatedResponse
object
Model for paginated audio emotion responses. Attributes: documents (List[AudioEmotionResponse]): List of audio responses. count (int): Total count of documents.
2 properties 2 required
ImageDBResponse
object
Detailed response model for image emotion stored in DB. Attributes: title (str): Title of the image. description (str): Description provided by the user. creat…
11 properties 11 required
Body_upload_image_v2_images_post
object
5 properties 1 required
ImageEmotionResponseV2
object
V2 response model for image emotion detection with URL source tracking. Supports: - File uploads (JPG, JPEG, PNG, WEBP) - Cloud storage URLs (Dropbox, direct U…
8 properties 7 required
ImageReprocessResponse
object
Response model returned after reprocessing an image emotion analysis.
3 properties 3 required
Body_add_note_to_specific_face_v1_images__image_id__faces__face_id__note_put
object
1 property
Body_reprocess_image_v1_images__image_id__put
object
2 properties
ImageNoteResponse
object
Response after updating or retrieving notes for an image.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

imentiv-ai-image-emotion-api-api-openapi.yml Raw ↑

Other APIs Imentiv AI publishes across the network.

Imentiv AI AI Insights API API
Imentiv AI Audio Emotion API API
Imentiv AI Report API API
Imentiv AI Text Emotion API API
Imentiv AI Video Emotion API API