v1

latestOpenAPI 3.1.02026-07-2310742.5 KB

Submit a MotionMockups AI Request

Queue a video generation request for the provided image and return a request_id to poll.

Provide your own prompt for full control, or omit it to let the API generate a prompt from the image (set skip_discovery: true to skip auto-prompting and use a neutral default instead). Allowed duration and aspect_ratio values depend on the selected model — see GET /motion-mockups/models.

post/motion-mockups/submit

Headers

Accept'application/json' required

The request must accept JSON responses.

x-api-keystring required

API key required for authentication.

Request body

start_image_urlstring uri required

Publicly accessible URL of the source image to animate.

model'kling_v2.6' | 'kling_v3_pro'

The MotionMockups AI model to use. Defaults to the standard model when omitted.

promptstring

Optional text prompt describing the desired video. When omitted, a prompt is generated from the image.

negative_promptstring

Optional description of what to avoid in the generated video.

durationinteger

Video length in seconds. Allowed values depend on the selected model (see GET /motion-mockups/models). Defaults to the model's default duration.

aspect_ratiostring

Output aspect ratio. Only supported by some models, with a model-specific set of allowed values (see GET /motion-mockups/models).

generate_audioboolean

Whether to also generate audio. Increases the credit cost by a model-specific multiplier.

skip_discoveryboolean

When true and no prompt is provided, skip image auto-prompting and use a neutral default prompt.

Response

Request successfully queued.

successboolean

messagestring