Submit Digital Human Generation Task

POST

/topview/v1/photo_avatar/task/submit

Reference: https://docs.topview.ai/reference/get_new-endpoint-58

Pricing: avatar2: 0.1ptc/s, avatar4：0.025PTC/s，avatar4Fast：0.015PTC/s

Request

Header Params

Body Params application/json

Example

{
    "templateImageFileId": "8cfe010093be4427947029e781f3b2ce",
    "mode": "avatar4",
    "scriptMode": "text",
    "ttsText": "Hey, I’m Topview Avatar 4. Give me one picture, and I can make a video like this — natural, longer, and doing the moves you want.",
    "voiceId": "zeeTdrCqbhpVKOucLtOKdhytM7rbJx5t",
    "avatarId": "4ab61621aad940ff84784ad8f005953a"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/topview/v1/photo_avatar/task/submit' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "templateImageFileId": "8cfe010093be4427947029e781f3b2ce",
    "mode": "avatar4",
    "scriptMode": "text",
    "ttsText": "Hey, I’m Topview Avatar 4. Give me one picture, and I can make a video like this — natural, longer, and doing the moves you want.",
    "voiceId": "zeeTdrCqbhpVKOucLtOKdhytM7rbJx5t",
    "avatarId": "4ab61621aad940ff84784ad8f005953a"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "200",
    "message": "Success",
    "result": {
        "taskId": "9d1ddfd341b447849752a6b248c7da85",
        "status": "success",
        "errorMsg": null
    }
}

Modified at 2026-01-23 07:05:43

Query Image2video (Image to Video)

Get Digital Human Generation Task Result