---
title: "Upload Streaming Avatar"
method: POST
path: "/api/open/v3/avatar/create"
tags: ["Avatar Management"]
---

# Upload Streaming Avatar

`POST /api/open/v3/avatar/create`

Create a new streaming avatar from a video URL

## Request body

- CreateAvatarRequest
  - `url` string, required — Avatar resource link. It is recommended that the video be about one minute long, and the avatar in the video content should rotate at a small angle and be clear.
  - `avatar_id` string, required — Avatar unique ID, can only contain alphanumeric characters
  - `name` string, required — Avatar display name for easier identification and management
  - `type` 2, required — Avatar type 2 represents stream avatar. When type is 2, you need to wait until status is 3 before you can use it. You can get the current status in real time through the Get Avatar Detail API.
  - `url_from` 1 | 2, required — URL source, 1 means akool and other links, 2 means other third-party links (currently only supports YouTube / TikTok / X / Google Drive)

## Response `200`

Avatar created successfully

- object
  - `code` integer, required — Interface returns business status code (1000: success)
  - `msg` string, required — Interface returns status information
  - `data` AvatarDetail
    - `_id` string — Internal ID
    - `uid` integer — User ID
    - `type` integer — Avatar type identifier (2 for streaming avatars)
    - `from` integer — Source identifier for the avatar, 2 for official and 3 for user created
    - `avatar_id` string — Unique identifier for the streaming avatar
    - `voice_id` string — Associated voice model identifier
    - `name` string — Display name of the avatar
    - `url` string — URL to access the streaming avatar
    - `thumbnailUrl` string — URL for the avatar's preview thumbnail
    - `gender` string — Avatar's gender designation
    - `available` boolean — Indicates if the avatar is currently available for use
    - `platform` string — Platform identifier

---

[API](https://skmtc.dev/akool/apis/face-detection-api.md) · [All operations](https://skmtc.dev/akool/apis/face-detection-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akool/face-detection-api/revisions/ce2ff5679949/schema)