Skip to main content

Upload Image

POST 
/v2/images

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

Request​

Responses​

Successful Response