v1
latestOpenAPI 3.1.02026-07-1381127211.1 KBImage 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:
- Submit your image and receive an immediate response with an image ID
- Image is queued for processing (typically completes within seconds)
- Optionally receive a webhook notification via callback_url when complete
- 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