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

# Instant Avatar

`POST /avatars/instant`

## Request

- Base URL: `https://genai-avatars-api.picsart.io/v1`
- URL: `https://genai-avatars-api.picsart.io/v1/avatars/instant`
- Auth: API key in header `X-Picsart-API-Key`

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

- object
  - `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.
  - `model` 'urn:air:picsart:model:picsart:dreamshaper-sfw@1' | 'urn:air:picsart:model:picsart:3d-cartoon@1' | 'urn:air:picsart:model:picsart:yamers-anime@1' | 'urn:air:fluxai:model:fluxai:flux-2-flex@1' | 'urn:air:fluxai:model:fluxai:flux-2-pro@1' | 'urn:air:fluxai:model:fluxai:flux-2-max@1' | 'urn:air:fluxai:model:fluxai:flux-2-pro-preview@1' | 'urn:air:google:model:google:gemini-3-pro-image-preview@1' | 'urn:air:google:model:google:gemini-3.1-flash-image-preview@1' | 'urn:air:google:model:google:gemini-3-pro-image@1' | 'urn:air:google:model:google:gemini-3.1-flash-image@1' | 'urn:air:google:model:google:gemini-3.1-flash-lite-image@1' | 'urn:air:ideogram:model:ideogram:ideogram@3' | 'urn:air:sdxl:model:fluxai:flux_kontext_max@1' | 'urn:air:sdxl:model:fluxai:flux_kontext_pro@1' | 'urn:air:seedream:model:seedream:seedream@4.0' | 'urn:air:seedream:model:seedream:seedream@4.5' | 'urn:air:seedream:model:seedream:seedream@4.7' | 'urn:air:seedream:model:seedream:seedream@5.0-lite' | 'urn:air:seedream:model:seedream:seedream@5.0-pro' | 'urn:air:openai:model:openai:gpt-image-1@1' | 'urn:air:runway:model:runway:gen4-image-ref@1' | 'urn:air:qwen:model:qwen:qwen-image-2.0-pro@1' | 'urn:air:qwen:model:qwen:qwen-image-3.0@1' | 'urn:air:qwen:model:qwen:qwen-image-3.0-pro@1' | 'urn:air:xai:model:xai:grok-imagine-image-edit@1' | 'urn:air:xai:model:xai:grok-imagine-image-2.0-edit@1' | 'urn:air:kling:model:kling:kling-image-o1@1' | 'urn:air:kling:model:kling:kling-v3-omni@1' | 'urn:air:fluxai:model:fluxai:flux-3-image@1' | 'urn:air:ideogram:model:ideogram:ideogram@4.5' | 'urn:air:luma:model:luma:uni-1@1' | 'urn:air:luma:model:luma:uni-1-max@1' | 'urn:air:wan:model:wan:wan-2.6-image@1' | 'urn:air:meta:model:meta:muse-image-1.0@1' | 'urn:air:picsart:model:picsart:qwen-image-edit@1' | 'urn:air:kling:model:kling:kling-v3@1', nullable: Optionally choose a specific AI model to use for this request. If not specified, the model configured for your API key is used, and where none is configured a default model will be applied. Please note that the default model may change over time as Picsart continues to improve performance and accuracy. Any change to the default will be made only after thorough testing and validation to ensure it delivers better results. If you require consistent behavior or wish to evaluate different models on your own, we recommend explicitly setting this parameter.

## 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
- `529`: Overloaded. The model provider is overloaded and could not complete this request. Please retry shortly, or switch to a different model.

---

[API](https://skmtc.dev/picsart/apis/picsart-genai-avatars-api.md) - [All operations](https://skmtc.dev/picsart/apis/picsart-genai-avatars-api/llms.txt) - [OpenAPI document](https://skmtc.dev/picsart/apis/picsart-genai-avatars-api/revisions/42b369953263?raw)