Product Image2Video V2 Summit

POST

/topview/v2/product_avatar/task/image2Video/submit

Product Image2Video is an API for converting product digital human image to video provided by the Topview platform. It supports users to automatically generate dynamic videos from specified materials such as product images and digital human images through AI technology, and is widely used in scenarios such as e-commerce display, marketing content, and short video creation.

The generation speed of this interface is relatively slow.

Demo Video

**Price:
Avatar 1 (lite): 0.625 PTC + n
Avatar 1 (pro): 1.25 PTC + n
n is determined by the number of characters in the script (0.25 PTC per 400 characters) or the duration of the imported audio (0.25 PTC per 30 seconds).

Avatar 2: Deducted based on the duration of text dubbing (0.1 PTC/second, maximum 28 seconds)
Avatar 4: Deducted based on the duration of text dubbing (0.0625 PTC/second, maximum 120 seconds)
Avatar 4Fast: 0.0375 PTC/second**

Request

Header Params

Body Params application/json

Example

{
    "replaceProductTaskImageId": "7e66ece3b4384e929fff91da2918e2d6",
    "mode": "pro",
    "scriptMode": "text",
    "ttsText": "test product avatar",
    "voiceId": "zeeTdrCqbhpVKOucLtOKdhytM7rbJx5t",
    "captionId": "3cfcb29df99746d4b438e169dda47647"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/topview/v2/product_avatar/task/image2Video/submit' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "replaceProductTaskImageId": "7e66ece3b4384e929fff91da2918e2d6",
    "mode": "pro",
    "scriptMode": "text",
    "ttsText": "test product avatar",
    "voiceId": "zeeTdrCqbhpVKOucLtOKdhytM7rbJx5t",
    "captionId": "3cfcb29df99746d4b438e169dda47647"
}'

Responses

🟢200success

application/json

Body

Example

{
    "code": "200",
    "message": "Success",
    "result": {
        "taskId": "4202c9e3ade344ffb8d991e5a2595f56",
        "status": "success",
        "errorMsg": null,
        "subTaskId": "4202c9e3ade344ffb8d991e5a2595f56"
    }
}

Modified at 2025-12-10 03:48:55

Query Product Categories

Product Image2Video V2 Query