デジタルヒューマン生成タスクを提出

POST

/topview/v1/photo_avatar/task/submit

参考：https://docs.topview.ai/reference/get_new-endpoint-58

価格：avatar2：0.1ptc/s、avatar4：0.06PTC/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 sk-mfYQzy0XTFfz4P16vRE4gFrKK1Nly4TozsMqbbb9PSiJUvFO' \
--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

🟢200成功

application/json

Body

Example

{
    "code": "200",
    "message": "Success",
    "result": {
        "taskId": "f4b4cabbdb204c7783e903f755e6f110",
        "status": "success",
        "finishedVideoCoverUrl": "https://file.302ai.cn/gpt/imgs/20250905/bdabcd21272687227d56edca58094b35.jpg",
        "finishedVideoUrl": "https://file.302ai.cn/gpt/imgs/20250905/66fa57424196b73a7ab16098f310477b.mp4"
    }
}

Modified at 2025-09-09 02:50:12

Image2video検索（画像から動画）

デジタルヒューマン生成タスク結果を取得