---
title: "Submit Task"
method: POST
path: "/v1/common_task/motion_control/task/submit"
---

# Submit Task

`POST /v1/common_task/motion_control/task/submit`

Submit an async Motion Control task and receive `taskId`. Poll the query endpoint for final result.

Constraints:
- Input resources are fileIds
- Character image supports jpg/jpeg/png
- Motion reference video supports mp4/mov
- Both image and video are validated by FFmpeg media parsing

## Headers

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

## Request body

- object
  - `model` 'Kling Motion Control Pro V3' | 'Kling Motion Control Std V3' | 'Kling Motion Control Pro' | 'Kling Motion Control Std', required — Display model name (required)
  - `characterImageFileId` string, required — Character image fileId (required)
  - `motionReferenceVideoFileId` string, required — Motion reference video fileId (required)
  - `prompt` string — Positive prompt (optional)
  - `resolution` 720 | 1080, required — Resolution (required), must match model capability
  - `characterOrientation` 'video' | 'image' — Character orientation (optional): video / image, default video
  - `keepOriginalSound` boolean — Keep original sound from reference video (optional, default true)
  - `boardId` string — Board ID (optional)
  - `noticeUrl` string — Task completion callback URL (optional)

## Response `200`

Accepted

- object
  - `code` string
  - `message` string
  - `result` object
    - `taskId` string — Task ID
    - `status` 'init' | 'running' | 'success' | 'fail' — Submit acceptance status
    - `boardTaskIds` string[] — Returned when board integration is enabled
    - `boardId` string — Returned when board integration is enabled
    - `noticeUuid` string — Returned when `noticeUrl` is provided

---

[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)