How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.0, at version 1.0.0.

Requests are made against a single 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.2.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.

HTTPValidationError
object
1 property
ImageReprocessResponse
object
Response model returned after reprocessing an image emotion analysis.
3 properties 3 required
ImageEditResponse
object
Model for editing image metadata. Attributes: title (str): Updated title. description (str): Updated description.
2 properties
Body_upload_image_v2_images_post
object
5 properties 1 required
ValidationError
object
3 properties 3 required
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
Body_edit_image_metadata_v1_images__image_id__metadata_put
object
4 properties
ImageDeleteResponse
object
Response returned after deleting an image analysis result.
2 properties 2 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
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
Body_add_note_to_specific_face_v1_images__image_id__faces__face_id__note_put
object
1 property

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
Where this information came from

This is an independent, third-party profile of Imentiv AI Image Emotion API API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.