Generation

Bring a still to life

vidmoat-image-live-1: animate a still. See the model card under Models. Camera moves use depth parallax; ambient, object, face, body and vehicle motion use the generative tier, our own Wan 2.2 model, where it is available. Nothing is added to the picture. Returns a job to poll.

Priced per second: 8 credits a second for camera moves and region cinemagraphs, 2 to 10 seconds (40 for the 5-second default); 24 credits a second for the generative tier, 4 or 5 seconds in 16:9, 9:16 or 1:1, without loop, taking about 2 to 5 minutes. quoteOnly shows which tier a request gets, and the quote is the charge. Setting region, motion, box, strength or direction keeps a request on the cheaper tiers. Anything appearing, pouring, breaking or transforming is refused before charging with a 400 that points to Generate a video, and so are faces, people, vehicles and turning objects where the generative tier is not available. Every clip is measured before delivery; one that does not move, moves outside its region or drifts from the still ends FAILED and is refunded. Video only, no audio track. Uses the ai.video scope so the same key can poll the job.

post/ai/live-images

Request

  • Base URL: https://api.vidmoat.com/v1
  • URL: https://api.vidmoat.com/v1/ai/live-images
  • Auth: HTTP bearer

Request body

imageobject required

{ "url": "https://..." } or { "uploadId": "..." } (an upload in your account). imageUrl is accepted instead.

promptstring required

The motion, up to 500 characters: "slow push-in", "steam rises from the cup", "the sneaker floats".

durationSecinteger

Whole seconds, 2 to 10 (the generative tier: 4 or 5). Billed on exactly this number.

aspectRatio'source' | '16:9' | '9:16' | '1:1' | '4:5' | '5:4' | '4:3' | '3:4'

Output is 720p on the short side.

mode'auto' | 'camera' | 'ambient' | 'object' | 'face' | 'body' | 'generative'

Force the class instead of reading it from the prompt. face, body and generative need the generative tier.

move'push' | 'pull' | 'drift' | 'orbit' | 'pan'

Camera move.

regionstring

What moves in ambient mode: water, waterfall, waves, clouds, smoke, steam, fire, leaves, wheat, grass, hair, flag, curtain and more.

motion'float' | 'bob' | 'sway' | 'tilt' | 'drive'

Object motion on the cut-out subject.

direction'up' | 'down' | 'left' | 'right'

Direction of the move or flow.

strengthnumber

0.25 to 2.

boxobject

{ x, y, width, height } as fractions of the frame: where the region or subject is.

loopboolean

Make the end meet the start. One-way moves (push, pull, drift, pan, drive) cannot loop and are refused.

seedinteger

For a repeatable result.

projectIdstring

Project to attach the job to.

maxCreditsnumber

Never spend more than this.

quoteOnlyboolean

true returns the tier, method and price without starting a job.

Response

Bring a still to life

idstring

The job id. Poll it with Get a generation job.

statusstring

PROCESSING.

quoteobject

{ credits, tier, motionClass, method }.

creditsobject

{ charged, remaining, basis }.

pollstring

The path to poll.

Changes

No recorded changes to this operation across all 1 revision of this API.