ludo
Ludo.ai API
postGenerate a short video clip from a source image and a motion text prompt (image-to-video). Synchronous: the call blocks until rendering finishes and returns the video URL and its actual duration in seconds — there is no separate polling step. Optionally pass `final_image` to interpolate between a start and end frame. The chosen `model` and `duration` must be compatible (incompatible combinations return HTTP 400); see the `model` and `duration` fields for the values each model accepts. Credits are charged only on success, based on the produced duration and never more than the duration you requested. Pass an optional `request_id` to tag the result so you can locate it later via `getVideoResults`. Related tools: use `createImage` for static images, `animateSprite` for sprite-sheet animation, and `getVideoResults` to list videos you generated earlier. Requires an API key (user scope).

latestSwagger 2.02026-08-19218237253.7 KB

3af866d68651

Videos

Generate a short video clip from a source image and a motion text prompt (image-to-video). Synchronous: the call blocks until rendering finishes and returns the video URL and its actual duration in seconds — there is no separate polling step. Optionally pass `final_image` to interpolate between a start and end frame. The chosen `model` and `duration` must be compatible (incompatible combinations return HTTP 400); see the `model` and `duration` fields for the values each model accepts. Credits are charged only on success, based on the produced duration and never more than the duration you requested. Pass an optional `request_id` to tag the result so you can locate it later via `getVideoResults`. Related tools: use `createImage` for static images, `animateSprite` for sprite-sheet animation, and `getVideoResults` to list videos you generated earlier. Requires an API key (user scope).

post/assets/video

Request body

imagestring required

URL or base64-encoded source image (the starting frame for the video)

promptstring required

Text description of the motion or action for the video (e.g., "walking forward", "waving hand", "camera zoom in")

augment_promptboolean

Augment the prompt behind the scenes. Disable to have more control.

final_imagestring

URL or base64-encoded end frame image. When provided, the video will interpolate between the initial and final frames.

durationnumber float

Video duration in seconds. Available values depend on the model — the source of truth is MODEL_PRICING (credits.js), surfaced via /credits/costs; the public API docs list them per model (auto-generated).

model'blitz' | 'eagle' | 'eagle-audio' | 'standard'

Video generation model to use.

request_idstring

Optional client-provided identifier for this request. Use this to retrieve results later via the results endpoint.

Example request

{
  "image": "<url> OR data:image/png;base64,...",
  "final_image": "<url> OR data:image/png;base64,...",
  "duration": 3,
  "model": "blitz"
}

Response

Success

urlstring

URL to the generated video file

durationnumber float

Duration of the video in seconds

has_audioboolean

request_idstring

created_atinteger