---
title: "Submit Task"
method: POST
path: "/v1/common-task/video-object-remove/submit"
---

# Submit Task

`POST /v1/common-task/video-object-remove/submit`

Submit an asynchronous video object-remove task. Returns a taskId for polling via the query API. Credits are charged after completion based on video duration. Use costCredit in the query response to check consumption.

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Request body

- object
  - `mode` 'auto' | 'clear-inside' | 'clear-outside', required — Removal mode. auto: full-frame auto removal, selectionBox may be omitted. clear-inside: remove the content inside the selection box. clear-outside: remove content outside the selection box (i.e. keep inside).
  - `videoFileId` string, required — Video fileId returned from the upload API (required). Must be of type video and use a supported video format.
  - `selectionBox` object — Selection area in percent of video width/height (0~100). Required for clear-inside and clear-outside modes; may be omitted for auto mode. Constraints: x+w ≤ 100, y+h ≤ 100, and after mapping to pixels the shorter edge must be ≥ 4 pixels. **[Reference Doc](https://docs.topview.ai/reference/selectionbox-parameter-reference)**
    - `x` number, float, required — Top-left x coordinate (percent, 0~100)
    - `y` number, float, required — Top-left y coordinate (percent, 0~100)
    - `w` number, float, required — Width (percent, 0~100), must be greater than 0
    - `h` number, float, required — Height (percent, 0~100), must be greater than 0
  - `noticeUrl` string — Optional webhook URL invoked when the task completes. See official callback documentation.**[Reference Doc](https://docs.topview.ai/reference/post_notice-notice-url-check)**
  - `boardId` string — Optional associated Board ID

## Response `200`

Task submitted successfully

- object
  - `code` string — Response status code
  - `message` string — Response message
  - `result` object — Task submission result
    - `taskId` string — Task ID for subsequent result queries
    - `status` 'init' | 'running' | 'success' | 'fail' — Acceptance status returned immediately after submit, always success (meaning the task was accepted). Use the query endpoint to poll the actual execution status.
    - `errorMsg` string — Error message when the task fails
    - `boardTaskIds` string[] — List of board task IDs (returned if task is associated with a board)
    - `boardId` string — Board ID (returned if task is associated with a board)
    - `noticeUuid` string — Notification UUID for async callback tracking

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/revisions/83cd46ca7859/schema)