---
title: "Upload Image"
method: POST
path: "/v2/images"
tags: ["Image Emotion API"]
---

# 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

## Response `200`

Successful Response

- ImageEmotionResponseV2 — V2 response model for image emotion detection with URL source tracking. Supports: - File uploads (JPG, JPEG, PNG, WEBP) - Cloud storage URLs (Dropbox, direct URLs) - URL source tracking Attributes: id (str): Unique ID of the image. title (str): Title of the image. status (str): Processing status ("queue"). media_source (str): Source type ("dropbox", "public_url", "file_upload"). media_source_url (str): Full URL as provided by user or uploaded file URL. media_source_type (str): Type of source media (always "image" for this endpoint). user_id (str): ID of the user who uploaded the image. created_at (Optional[str]): Timestamp when image was created.
  - `id` string, required
  - `title` string, required
  - `status` string, required
  - `media_source` string, required
  - `media_source_url` string, required
  - `media_source_type` string, required
  - `user_id` string, required
  - `created_at` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai.md) · [All operations](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/imentiv/welcome-to-imentiv-ai/revisions/74ceee4a5c98/schema)