Topview-api

submit task

Developing

POST

/v1/product_avatar/task/image2Video/submit

Request

Header Params

Authorization

string

required

Topview-Uid

string

required

Body Params application/json

productReplaceResultKey

string

required

It must be the result of the key of replace product image result

mode

enum<string>

required

lite/pro

Allowed values:

litepro

image2videoPrompt

string

optional

voiceoverId

string

required

ttsText

string

optional

preview text

Example:

Welcome to Topview, the ultimate AI-powered video editing platform that revolutionizes the way you create compelling videos. Whether you're a marketer, content creator, or business owner, Topview is here to transform your raw ideas into professional-grade videos effortlessly.

noticeUrl

string

optional

回调地址。详情看api文档

Example

{
    "productReplaceResultKey": "string",
    "mode": "lite",
    "image2videoPrompt": "string",
    "voiceoverId": "string",
    "ttsText": "Welcome to Topview, the ultimate AI-powered video editing platform that revolutionizes the way you create compelling videos. Whether you're a marketer, content creator, or business owner, Topview is here to transform your raw ideas into professional-grade videos effortlessly.",
    "noticeUrl": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.topview.ai/v1/product_avatar/task/image2Video/submit' \
--header 'Authorization;' \
--header 'Topview-Uid;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productReplaceResultKey": "string",
    "mode": "lite",
    "image2videoPrompt": "string",
    "voiceoverId": "string",
    "ttsText": "Welcome to Topview, the ultimate AI-powered video editing platform that revolutionizes the way you create compelling videos. Whether you'\''re a marketer, content creator, or business owner, Topview is here to transform your raw ideas into professional-grade videos effortlessly.",
    "noticeUrl": "string"
}'

Responses

🟢200OK

application/json

Body

code

string

required

message

string

required

result

object

required

taskId

string

required

status

string

required

errorMsg

string

required

Example

{
    "code": "string",
    "message": "string",
    "result": {
        "taskId": "string",
        "status": "string",
        "errorMsg": "string"
    }
}

Modified at 2025-05-28 08:12:15

query task