submit task

Developing

POST

/v1/common_task/image2video/submit

Request

Header Params

Authorization

string

optional

Topview-Uid

string

optional

Body Params application/json

imageFileId

string

required

Image fileId

prompt

string

optional

Prompt

negativePrompt

string

optional

Negative prompt

duration

enum<integer>

required

Video duration。Support 5 to10

Allowed values:

510

mode

enum<string>

required

Mode

Allowed values:

liteproplusbest

generatingCount

integer

required

Generating count。Support 1 to 4

noticeUrl

string

optional

Please refer to the API documentation for details

Example

{
    "imageFileId": "string",
    "prompt": "string",
    "negativePrompt": "string",
    "duration": 5,
    "mode": "lite",
    "generatingCount": 0,
    "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/common_task/image2video/submit' \
--header 'Authorization;' \
--header 'Topview-Uid;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageFileId": "string",
    "prompt": "string",
    "negativePrompt": "string",
    "duration": 5,
    "mode": "lite",
    "generatingCount": 0,
    "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-06-05 10:36:32

Public product avatar Query

query task