v1

latestOpenAPI 3.0.32026-07-241112213.6 KB

Submit Image2Video Task

Submit a Product Avatar Image2Video task with specified parameters.

post/v3/product_avatar/task/image2Video/submit

Request body

replaceProductTaskImageIdstring required

Obtain imageId parameter values from the interface Product Avatar - v3 - Replace Product Image - query task .</br> If faceExistence=false, only mode=avatar2 can be selected.

Example: 7e66ece3b4384e929fff91da2918e2d6

mode'avatar2' | 'avatar4' | 'avatar4Fast' required

Video generation effects:</br> avatar2: 1080p </br> avatar4: 1080p 120 seconds</br> avatar4Fast: 1080p 120 seconds</br>

scriptMode'text' | 'audio' required

Script mode type

ttsTextstring

1. In scriptMode=text mode, ttsText cannot be empty.</br>

2. voiceText can use the<break time=\ "1.0s "/>tag to specify how long to pause at the break location (0.1-99.9, up to one decimal place). </br>

Example: welcome to <break time=\ "1.0s "/> topview.When reading "to", there will be a pause of 1 seconds, and then continue reading "topview".

voiceIdstring

In scriptMode=text mode, voiceId cannot be empty. Obtain parameters from the voice query interface.</br>

Example: 4wCRn52HpjUHggIPXfcQsAaFkKaj5AtM

audioFileIdstring

In scriptMode=audio mode, audioFileId cannot be empty. </br> For avatar2 mode, audio duration must be <= 28s.</br> For avatar4/avatar4Fast, audio duration must be <= 120s.</br>

Example: 4373457097c54dd9944c931d0bdf9c47

captionIdstring

Obtain parameter values from the caption list interface.

noticeUrlstring

Callback URL for task completion notification. Please refer to the API documentation for details NoticeUrl

Response

Successful response

codestring required

200:success Other:fail

messagestring required