v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB
Image Emotion API

Upload Image

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
  • Professional and Enterprise plans: 5 credits per image
post/v2/images

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