---
updatedAt: 2026-01-09T04:00:41.000Z
agentTools:
  projectIndex: https://docs.topview.ai/llms.txt
---

# Submit Task(Image2Video)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "PA2 Image2Video Submit Task"
  },
  "servers": [
    {
      "url": "https://api.topview.ai"
    }
  ],
  "paths": {
    "/v3/product_avatar/task/image2Video/submit": {
      "post": {
        "summary": "Submit Image2Video Task",
        "description": "Submit a Product Avatar Image2Video task with specified parameters.",
        "operationId": "post_v2product_avatartaskimage2Videosubmit",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "scriptMode",
                  "replaceProductTaskImageId",
                  "mode"
                ],
                "properties": {
                  "replaceProductTaskImageId": {
                    "type": "string",
                    "description": "Obtain `imageId` parameter values from the interface **[Product Avatar - v3 - Replace Product Image - query task](https://docs.topview.ai/reference/pa3_replace_product_image_query_task)** .</br>\n If faceExistence=false, only mode=avatar2 can be selected.\n\nExample: 7e66ece3b4384e929fff91da2918e2d6"
                  },
                  "mode": {
                    "type": "string",
                    "description": "Video generation effects:</br>\navatar2: `1080p` </br>\navatar4: `1080p`  `120 seconds`</br>\navatar4Fast: `1080p`  `120 seconds`</br>",
                    "default": "",
                    "enum": [
                      "avatar2",
                      "avatar4",
                      "avatar4Fast"
                    ]
                  },
                  "scriptMode": {
                    "type": "string",
                    "description": "Script mode type",
                    "enum": [
                      "text",
                      "audio"
                    ],
                    "default": "text"
                  },
                  "ttsText": {
                    "type": "string",
                    "description": "`1.` In scriptMode=text mode, ttsText cannot be empty.</br>\n\n`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>\n\nExample: welcome to <break time=\\ \"1.0s \\\"/> topview.When reading \"to\", there will be a pause of 1 seconds, and then continue reading \"topview\"."
                  },
                  "voiceId": {
                    "type": "string",
                    "description": "In scriptMode=text mode, voiceId cannot be empty. Obtain parameters from the **[voice query interface](https://docs.topview.ai/reference/voice_query)**.</br>\n\nExample: 4wCRn52HpjUHggIPXfcQsAaFkKaj5AtM"
                  },
                  "audioFileId": {
                    "type": "string",
                    "description": "In scriptMode=audio mode, audioFileId cannot be empty. </br>\nFor avatar2 mode, audio duration must be <= 28s.</br>\n For avatar4/avatar4Fast, audio duration must be <= 120s.</br>\n\nExample: 4373457097c54dd9944c931d0bdf9c47"
                  },
                  "captionId": {
                    "type": "string",
                    "description": "Obtain parameter values from the **[caption list interface](https://docs.topview.ai/reference/get_v1-caption-list)**."
                  },
                  "noticeUrl": {
                    "type": "string",
                    "description": "Callback URL for task completion notification. Please refer to the **[API documentation for  details NoticeUrl](https://docs.topview.ai/reference/post_notice-notice-url-check#/)**"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "200:success   Other:fail"
                    },
                    "message": {
                      "type": "string"
                    },
                    "result": {
                      "type": "object",
                      "description": "When code is 200, the result content will be returned.",
                      "properties": {
                        "taskId": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "success",
                            "fail"
                          ]
                        },
                        "errorMsg": {
                          "type": "string"
                        },
                        "noticeUuid": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "taskId",
                        "status"
                      ]
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "Topview-Uid": [],
            "Authorization": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "Topview-Uid": {
        "type": "apiKey",
        "in": "header",
        "name": "Topview-Uid"
      },
      "Authorization": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "useage example: Bearer {your Authorization}"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```