---
title: "Instant Avatar"
method: POST
path: "/avatars/instant"
tags: ["Avatar"]
---

# Instant Avatar

`POST /avatars/instant`

This is a simplified version of the avatar service which requires only one image and one request to generate the avatar. The process is asynchronous and will require an additional call to get the result. See below for more details.

## Request body

- InstantAvatarParameters
  - `images` string[], required — The list of images to generate the avatars for. There should be at least one image URL provided. It's required to use either JPG (recommended) or PNG images, as well as for the best performance all files are recommended to be downsized to 512x512 pixels.
  - `prompt` string, required — The prompt.
  - `negative_prompt` string — The negative prompt (don’t generate this type of avatars). Don't use the nagitve keywords such as 'no', e.g. don't use 'no distorted faces', use 'distorted faces'. The usage of this negative prompt is not guaranteed.
  - `count` number — The number of avatars to generate.

## Response `202`

Accepted.

- object
  - `status` 'processing' | 'error' | 'success' — The status of the submitted request. Pay attention to handle these properly: * processing * error * success For instance, if the images submitted are reported as not valid, then you may not expect to get the inference results. You will need to fix the images and then resubmit.
  - `inference_id` string — The unique identifier of this inference.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `413` — Request Entity Too Large
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `431` — Request Header Fields Too Large
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/picsart/apis/picsart-programmable-image-apis.md) · [All operations](https://skmtc.net/picsart/apis/picsart-programmable-image-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/picsart/picsart-programmable-image-apis/versions/726b2a637ae8/schema)