Create Private Digital Avatar

POST

/topview/v1/common_task/video2aiAvatar/submit

Video2aiAvatar is the core API of the Topview platform for converting local videos into exclusive AI digital human (AI Avatar) models with one click. Before using this API, you need to upload your local video via the file upload API and obtain the fileId.
Avatar Preview Image
Avatar Preview Video
Price: 0 PTC/time

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

avatarName

string

required

videoFileId

string

required

Example

{
    "avatarName": "302",
    "videoFileId": "fc427c05a485444cb5ec1e558ac7fab9"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/topview/v1/common_task/video2aiAvatar/submit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "avatarName": "302",
    "videoFileId": "fc427c05a485444cb5ec1e558ac7fab9"
}'

Responses

🟢200成功

application/json

Body

code

string

required

message

string

required

result

object

required

taskId

string

required

status

string

required

errorMsg

null

required

Example

{
    "code": "200",
    "message": "Success",
    "result": {
        "taskId": "17cdb374fbca48a6ad71c47cc99b633e",
        "status": "success",
        "errorMsg": null
    }
}

Modified at 2025-07-15 08:41:55

VideoAvatar Query

Query Private Digital Avatar