---
title: "Avatar training status"
method: GET
path: "/v1/avatars/{avatar_id}"
tags: ["Avatars"]
---

# Avatar training status

`GET /v1/avatars/{avatar_id}`

## Request

- Base URL: `https://api.vivideo.ai`
- URL: `https://api.vivideo.ai/v1/avatars/{avatar_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vivideo/apis/vivideo-api/docs/v1/avatars/:avatar_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `avatar_id` string, required

## Response `200`

Training status; use it in videos once `ready` is true.

- Avatar
  - `id` string: avatar_ref (av_...) for your avatars, or the catalogue avatar_id.
  - `object` string
  - `name` string
  - `kind` 'prompt' | 'photo'
  - `status` string
  - `ready` boolean
  - `gender` string
  - `preview_image_url` string
  - `preview_video_url` string
  - `looks` object[]

## Other responses

- `401`: Missing, malformed or revoked API key (`missing_api_key`, `invalid_api_key`, `api_key_revoked`).
- `404`: The resource does not exist for this account (`not_found`).

---

[API](https://skmtc.dev/vivideo/apis/vivideo-api.md) - [All operations](https://skmtc.dev/vivideo/apis/vivideo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vivideo/apis/vivideo-api/revisions/6e8a47e72b46?raw)