Bring a still to life
POST
https://api.vidmoat.com/v1/ai/live-imagesvidmoat-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.
Body#
imageobjectrequired{ "url": "https://..." }or{ "uploadId": "..." }(an upload in your account).imageUrlis accepted instead.promptstringrequiredThe motion, up to 500 characters: "slow push-in", "steam rises from the cup", "the sneaker floats".durationSecintegerdefault5Whole seconds, 2 to 10 (the generative tier: 4 or 5). Billed on exactly this number.aspectRatioenumdefaultsourceOutput is 720p on the short side.One ofsource,16:9,9:16,1:1,4:5,5:4,4:3,3:4modeenumdefaultautoForce the class instead of reading it from the prompt. face, body and generative need the generative tier.One ofauto,camera,ambient,object,face,body,generativemoveenumCamera move.One ofpush,pull,drift,orbit,panshotobjectOptional shot preset,{ move?, pace? }: movepush_in,pull_out,orbit,panortruck; paceslow,normalorfast(sets strength). The living image is routed by this choice, not by the prompt words. Other shot moves are refused with the nearest one (use Generate a video for them). Not combined withmoveorstrength.regionstringWhat moves in ambient mode: water, waterfall, waves, clouds, smoke, steam, fire, leaves, wheat, grass, hair, flag, curtain and more.motionenumObject motion on the cut-out subject.One offloat,bob,sway,tilt,drivedirectionenumDirection of the move or flow.One ofup,down,left,rightstrengthnumberdefault10.25 to 2.boxobject{ x, y, width, height }as fractions of the frame: where the region or subject is.loopbooleandefaultfalseMake the end meet the start. One-way moves (push, pull, drift, pan, drive) cannot loop and are refused.seedintegerFor a repeatable result.projectIdstringProject to attach the job to.maxCreditsnumberNever spend more than this.quoteOnlybooleantruereturns the tier, method and price without starting a job.
Response#
Returns 202.
Response fields#
idstringThe job id. Poll it with Get a generation job.statusstringPROCESSING.modelstringvidmoat-image-live-1.durationSecintegerSeconds billed.quoteobject{ credits, tier, motionClass, method }.actionVerifiedbooleanPresent (false) when the motion asked for could not be confirmed in advance;actionCaveatsays why andposeChangenames a pose change that was read from the prompt.creditsobject{ charged, remaining, basis }.pollstringThe path to poll.quoteOnlybooleanWithquoteOnly: truethe reply is{ quoteOnly, model, quote: { credits, perSecond, durationSec, tier, motionClass, method }, available, unavailableReason? }and no job is started.
Errors#
Besides the errors any request can get (authentication, rate limits):
| Status | Code | When |
|---|---|---|
| 400 | invalid_request | No image or prompt, an unsupported option, a motion only Generate a video can make, or a quote above maxCredits. |
| 404 | not_found | projectId is not one of your projects. |
| 402 | plan_required | The account is on Hobby. Living images come with Creator and every plan above it. |
| 402 | insufficient_credits | The balance cannot cover the call. Nothing ran. remaining is the balance. |
| 402 | quota_exceeded | A living image is already being made on the account. |
| 501 | not_configured | The living-image worker is not available on this deployment. |
| 503 | unavailable | The generative tier has used its GPU time for the month. Camera moves and region cinemagraphs still work; nothing was charged. |
| 422 | prompt_rejected | The prompt failed the safety check. Nothing was charged. |