Submit Avatar Marketing Video

POST

/topview/v1/m2v/task/submit

Avatar Marketing Video is Topview's product marketing video generation tool. Users can upload product images, scripts, or materials to easily generate videos demonstrating the product being worn or interacted with, supporting multiple languages.
Demo Video

Price: 2 PTC/time

If both productLink and fileIds parameters are provided, the fileIds parameter will be ignored, and all videos and images parsed from productLink will be used by default.
This interface is asynchronous. After a successful submission, an ID will be returned. Users can query the processing result through the Get Marketing video result interface.

Request

Header Params

Body Params application/json

Example

{
    "fileIds": [
        "8d745437254941adb141f95836d9454c"
    ],
    "productName": "8d745437254941adb141f95836d9454c.mp4",
    "productDescription": "303 talk"
}

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/m2v/task/submit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileIds": [
        "8d745437254941adb141f95836d9454c"
    ],
    "productName": "8d745437254941adb141f95836d9454c.mp4",
    "productDescription": "303 talk"
}'

Responses

🟢200成功

application/json

Body

Example

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

Modified at 2025-07-15 08:40:42

Fetch（Fetch Task）

Get Avatar Marketing Video Results