---
title: "Get the avatar video result."
method: GET
path: "/avatars/video/{inference_id}"
tags: ["Avatar"]
---

# Get the avatar video result.

`GET /avatars/video/{inference_id}`

## Request

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

Avatar video generation is initiated via the Avatar Video API and is an asynchronous process. To learn more about the status of the generation and whether the video is ready, regular checks should be done. The recommended intervals are
 * First check: 20 seconds.
 * Next checks: every 10 seconds.

## Path parameters

- `inference_id` string, required

## Response `200`

Success.

- object
  - `status` 'processing' | 'error' | 'success': The status of the submitted request. Pay attention to handle these properly: * processing * error * success
  - `data` object
    - `id` string: The identifier of the generated video.
    - `url` string, uri: The URL of the generated video.

## Other responses

- `202`: Still processing. Poll again.
- `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)