Gamestorming

Generates spritesheet from image (Roles: user)

Changed on
post/games/generate/image-to-spritesheet

Request

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

Request body

request_idstring
modelstring
descriptionsstring[]
game_idsstring[]
search_imagesinteger
image_typestring
contextstring
art_stylestring
perspectivestring
hintsstring[]
project_idstring
mask_imagestring
strengthnumber float
aspect_ratiostring
preserve_colorboolean
preserve_compositionboolean
preserve_detailsboolean
edit_modestring
camera_rotationinteger
camera_elevationinteger
loopboolean
cropboolean
framesnumber
frame_sizenumber
use_pixel_gridboolean
margin_rationumber float
margin_ratio_horizontalnumber float
margin_ratio_verticalnumber float
margin_ratio_modestring
durationnumber float
forceboolean

3D images with an initial_image_file - always redraw it as a 3D render, even when it is already a cut-out (by default a cut-out is used as is and any other image only has its background removed).

promptstring

3D images with an initial_image_file - instructions for redrawing it as a 3D render, e.g. "keep the sword in the right hand". Implies force.

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