---
title: "Upload image"
method: POST
path: "/images"
tags: ["Images"]
---

# Upload image

`POST /images`

Upload an image to a temporary storage before creating an animation.
The image is uploaded using multipart/form-data. the filename directive is optional and if provided should contain up to 50 valid characters long.
Valid characters: a-z A-Z 0-9 . _ -
Supported mime types: image/jpeg,image/png
Storage duration: 24-48H

## Response `201`

The image has been uploaded successfully

- UploadImageResponseDto
  - `url` string, required — The temporary URL of the image. This URL should be provided when creating an animation via the /animations endpoint.
  - `id` string — A unique identifier which represents this image operation
  - `faces` FaceSquare[]
    - `size` integer, required — Size of the square side
    - `top_left` Dimension[], required — Top left location of the face in the frame - can be negative
    - `overlap` 'NO' | 'PARTIAL' | 'YES' | 'UNKNOWN'
    - `face_id` string
    - `detect_confidence` number, double
    - `sharpness` number, double
    - `face_occluded` boolean
    - `face_occluded_confidence` number, double
    - `detection` Rect
      - `top` number, double, required
      - `left` number, double, required
      - `bottom` number, double, required
      - `right` number, double, required

## Other responses

- `400` — BadRequestError | InvalidFileSizeError | InvalidImageResolutionError
- `401` — AuthorizationError
- `402` — InsufficientCreditsError
- `415` — UnsupportedMimeTypeError
- `451` — ImageModerationError | CelebrityRecognizedError

---

[API](https://skmtc.net/d-id/apis/realtime-endpoints.md) · [All operations](https://skmtc.net/d-id/apis/realtime-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-id/realtime-endpoints/revisions/2f2425e1b6b6/schema)