Submit Task

post

https://api.topview.ai/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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

model

string

enum

required

Display model name (required)

Allowed:

characterImageFileId

string

required

Character image fileId (required)

motionReferenceVideoFileId

string

required

Motion reference video fileId (required)

prompt

string

Positive prompt (optional)

resolution

integer

enum

required

Resolution (required), must match model capability

Allowed:

characterOrientation

string

enum

Character orientation (optional): video / image, default video

Allowed:

keepOriginalSound

boolean

Keep original sound from reference video (optional, default true)

boardId

string

Board ID (optional)

noticeUrl

string

Task completion callback URL (optional)

Headers

Topview-Uid

string

required

Defaults to uid

User ID

Authorization

string

required

Defaults to Bearer apiKey

API key, format: Bearer {apiKey}

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Accepted