LUludo
Gamestorming

Generates spritesheet by transferring motion from video or spritesheet to image (Roles: user)

Changed on
post/games/generate/spritesheet-motion-transfer

Request

  • Base URL
    https://api.ludo.ai/api
  • Auth
    API key in header Authorization

Request body

request_idstring
videostring
num_framesnumber
target_frame_sizenumber
loopboolean
cropboolean
margin_rationumber float
margin_ratio_horizontalnumber float
margin_ratio_verticalnumber float
margin_ratio_mode'manual' | 'none'
model'hydra' | 'tango' | 'forge' | 'forge-pixel'
promptstring

Optional extra instructions for the motion transfer, added to the model's own prompt.

durationnumber float

Animation length in seconds. Available values depend on the model - see /credits/costs (per-model lists are auto-generated into the public API docs).

pixel_art_filterboolean
spritesheet_with_backgroundboolean
use_pixel_gridboolean

Response

Success

tagsstring[]
idstring
audio_b64string
durationnumber float
billed_durationnumber float

Seconds the generation was billed for: the length of the video Prometheus generated, never more than the duration the user requested. duration is the sheet's loop-trimmed length as Prometheus reports it and is usually shorter.

start_timestampnumber
end_timestampnumber
num_framesnumber
num_colsnumber

Columns in the frame grid. Absent on legacy sheets, which use a square grid of ceil(sqrt(num_frames)) per side.

num_rowsnumber

Rows in the frame grid. Absent on legacy sheets, which use a square grid of ceil(sqrt(num_frames)) per side.

max_num_framesnumber
margin_rationumber
margin_ratio_horizontalnumber float
margin_ratio_verticalnumber float
margin_ratio_modestring
target_frame_sizenumber
loopboolean
bad_loopboolean
out_of_frameboolean
cropboolean
original_promptstring
motion_promptstring
promptstring
seednumber
sprite_sheet_b64string
sprite_sheet_raw_b64string
sprite_sheet_watermarked_b64string

URL of the watermarked variant of sprite_sheet_b64 (a keyed "<token>_wmk" name the clean key cannot be read from; "<md5>_wm" on sheets minted before October 2026). Present only when generated by a free user; served IN PLACE of sprite_sheet_b64 to free viewers. sprite_sheet_b64 itself always stays the clean asset.

sprite_sheet_raw_watermarked_b64string

Watermarked variant of sprite_sheet_raw_b64 (see sprite_sheet_watermarked_b64).

watermarkedboolean

Response-only. True when the served sprite_sheet_b64 is the watermarked variant (free viewer). Never persisted - stripped from inbound bodies.

preview_video_b64string
first_frame_b64string
last_frame_b64string
has_audioboolean
modelstring

Codename of the model that generated (or last re-rendered) the animation, e.g. blitz, forge, tango. Absent on sheets created before it was recorded.

is_editedboolean

True when this spritesheet was produced by an edit (prompt, outpaint, or fix_loop) - the whole animation was re-rendered, so frames may drift from the original.

generation_modestring

How the ML produced the animation, as reported by it (e.g. image, edit, motion_transfer). Absent on sheets saved before it was recorded.

pixel_art_filterstring

Pixel-art filter the ML applied, as reported by it. Absent on sheets saved before it was recorded.

degradedboolean

Degraded flag as reported by the ML for this render. Absent when the ML did not report a boolean, and on sheets saved before it was recorded. Never null: swagger-tools ignores x-nullable, so a null here fails request validation.

use_pixel_gridboolean

The use_pixel_grid value this sheet was made with, when the caller set one (absent otherwise: true, the ML default, applied). Adjust, edit and new view inherit it when they do not set their own.

labelstring
preview_scalenumber float

Changes