Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Ludo AI Game Assets

REMOTE · MCP.LUDO.AI

Generate game assets with AI: sprites, animations, 3D models with rigging, video, music, SFX, voices

Available components

−1 this week 75 Trust /100

Last scanned (14 hours ago)

Scores higher than 62% of remote servers

Reachable. Last reached 21 Nov 2026.

Category Design and Media

Recent critical change

Authorization (16 Oct 2026). See the changelog before you install this server.

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security57
Transport & Reachability100
Schema Quality & AI Usability59
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 19026 tokens (~328/item across 58 items; 58 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage98
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 94% of tool parameters carry a description.Partial
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 59 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (13)

  • TLS certificate
  • Authorization
  • HTTPS
  • HSTS header
  • DNSSEC
  • Transport
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this hosted endpoint (2)

  • Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
  • Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 0
    • The server rewrote its instructions, which are the text every model session reads security
    • New tool “payTopup”, which the server declares destructive security
    • Tool “createTileset” rewrote its description, which is the text the model reads security
    • Tool “editTileset” rewrote its description, which is the text the model reads security
    • Tool “getAccount” rewrote its description, which is the text the model reads security
    • Tool “getPricing” rewrote its description, which is the text the model reads security
    • Tool coverage: 100% → 94% ▼ functional
    • New tool “createTopupLink” functional
    • New tool “getTopupLink” functional
    • New tool “getTopupQuote” functional
  • 20 Nov 26 0
    • Tool “upscaleImage” rewrote its description, which is the text the model reads security
  • 18 Nov 26 0
    • Tool “create3DModel” rewrote its description, which is the text the model reads security
    • New tool “createTile” functional
    • New tool “createTileset” functional
    • New tool “editTileset” functional
  • 17 Nov 26 −1
    • The server rewrote its instructions, which are the text every model session reads security
    • Tool “animateSprite” rewrote its description, which is the text the model reads security
    • Tool “animateSpriteKeyframes” rewrote its description, which is the text the model reads security
    • Tool “createSpriteAudio” rewrote its description, which is the text the model reads security
    • Tool “createVideo” rewrote its description, which is the text the model reads security
    • Tool “editSpritesheet” rewrote its description, which is the text the model reads security
    • Tool “transferMotion” rewrote its description, which is the text the model reads security
    • “animateSpriteKeyframes” reworded the description of “requestBody” cosmetic
  • 12 Nov 26 0
    • The server rewrote its instructions, which are the text every model session reads security
    • Tool “animate3DModelPreset” rewrote its description, which is the text the model reads security
    • Tool “listAnimationPresets” rewrote its description, which is the text the model reads security
    • Tool “transferMotion” rewrote its description, which is the text the model reads security
    • New tool “createAnimation” functional
    • New tool “listMyAnimations” functional
    • “animate3DModelPreset” reworded the description of “requestBody” cosmetic
    • “transferMotion” reworded the description of “requestBody” cosmetic
    • Tool “animate3DModelPreset” changed its title: Animate 3D model with a preset → Animate 3D model with a preset or your animation cosmetic
  • 11 Nov 26 +1
    • Stability: 0.97 → pass security
    • Tool “getPricing” rewrote its description, which is the text the model reads security
  • 10 Nov 26 −1
    • Stability: pass → 0.97 functional
  • 9 Nov 26 +1
    • Stability: 0.97 → pass security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Probed https://mcp.ludo.ai/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=mcp.ludo.ai CN=WR3,O=Google Trust Services,C=US 27 Oct 2026 25 Jan 2027 RSA 2048 SHA256-RSA 1b6223e6b7774024107dbb0bf579285a
SANs: mcp.ludo.ai
CN=WR3,O=Google Trust Services,C=US (CA) CN=GTS Root R1,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 RSA 2048 SHA256-RSA 7ff005a91568d63abc22861684aa4b5a
CN=GTS Root R1,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 19 Jun 2020 28 Jan 2028 RSA 4096 SHA256-RSA 77bd0d6cdb36f91aea210fc4f058d30d

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of mcp.ludo.ai. — Not signed

Zone DS Keys Algorithms Outcome
. Trust anchor 20326, 38696 8, 8 Verified
ai. DS published 1814 8 Verified
ludo.ai. No DS Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://mcp.ludo.ai/mcp Verified 200
http (plaintext) http://mcp.ludo.ai/mcp HTTPS enforced
MCP tools · 58 exposed · ~17,871 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
adjustSpritesheet ~411

Adjust Sprite Sheet: re-export a previously generated sprite animation with different sheet settings - frame count, frame size, loop trimming or whitespace cropping - without generating the animation again. Free (no credits). Pass the `spritesheet_url` you received from `animateSprite`, `animateSpriteKeyframes`, `transferMotion`, `editSpritesheet`, `rotateSpritesheet` or an earlier adjust - it must be a spritesheet you generated through the API within the last 7 days; arbitrary external images are not accepted. Omit a setting to keep the source's value. The animation itself is unchanged: this only re-cuts the same video into a new sheet, so use it to fix framing (for example an effect clipped by True Size: re-export with a fixed `frame_size` or 0), to change the frame count or size for your engine, to upscale it 1.5x (`frame_size` -1), to turn loop trimming on or off, or to pack it as ordinary art when its detected pixel grid is wrong for the asset (`use_pixel_grid` false). It cannot change the motion, margins or content - use editSpritesheet for that. The source is left as it is and the result is a new spritesheet with its own `spritesheet_url`. The job result is the same sprite result as animateSprite (`spritesheet_url`, `video_url`, grid fields, optional GIF and frame URLs, and the source's `audio_url` when it has one). Limited to 20 calls per 5 minutes, 120 an hour and 1000 a day. Pass an optional request_id to tag the result for later retrieval via listGenerations (type spritesheet). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions).

NameTypeReqDescription
requestBodyobjectyesPayload for re-exporting a previously generated sprite animation with different sheet settings (Adjust Sprite Sheet in the web app).

No output schema declared.

No examples provided.

animate3DModel ~295

Generate text-driven skeletal animations for an already-rigged 3D model. Pass the rigged GLB in `model` (URL or base64; the 3D asset file, not an AI model name) and a motion `prompt` (e.g. "walking", "swinging its axe"). The model must already have a skeleton - rig it first with rigModel if not. The job result is num_variants candidate animations (default 4), each a standalone animation-only GLB (skeleton + one clip, no mesh) in `glb_url` plus an mp4 `preview_url`, so you can pick the best one and fuse it with your model in a game engine or three.js. mode selects the representation - rot_trans (default, rotation plus translation per bone, most faithful) or rot_only (rotation only, easier to retarget onto another skeleton in an engine). Animation quality is hit-or-miss, which is why multiple candidates are returned. Credits are held once per call regardless of variant count and refunded if the job fails or is cancelled. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for animating a rigged 3D model from a text prompt

No output schema declared.

No examples provided.

animate3DModelPreset ~365

Apply a curated animation preset, or one of the account's generated animations, to an already-rigged 3D model (retargeting). Pass the rigged GLB in `model` (URL or base64; the 3D asset file, not an AI model name) and exactly one of a `preset_id` from the animation presets list (from listAnimationPresets; any preset id works) and an `animation_id` (the id of an animation from createAnimation or listMyAnimations). Set `mirror` to play the move on the other side, left and right swapped (a left-handed slash from a right-handed one). Any rig type can take a preset or an animation, though retargeting does not succeed on every model: when it does not, the job fails. The job result is one retargeted animation - a standalone animation-only GLB in `glb_url` plus an mp4 `preview_url` - in the same `animations` envelope as the animate endpoint. An animation that loops is trimmed to its seamless loop; a one-shot keeps its full arc. in_place removes net travel so the character moves on the spot, as game-engine locomotion expects (omit to apply it to animations that loop: a cycle stays on the spot, a one-shot keeps its travel). Credits are held when the job is accepted and refunded if it fails or is cancelled. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for animating a rigged 3D model with a preset animation or a generated animation

No output schema declared.

No examples provided.

animateSprite ~797

Animate a static sprite into a spritesheet driven by a motion text prompt (image-to-spritesheet): supply an initial_image (URL or base64) plus a motion_prompt like "walking" or "attack slash", and optionally a final_image to interpolate between a start and end frame. Describe the motion exactly and unambiguously, but do not over-describe it: an action the model already knows is one phrase, not a sequence of steps, and the character, art style, background and camera come from the image, not the prompt. For animations driven by up to three keyframes (including a middle frame), use animateSpriteKeyframes instead. The job result is a single sprite result: `spritesheet_url` (the sheet image), `video_url` (an mp4 of the animation - pass it as `video` to transferMotion or as `spritesheet_video_url` to createSpriteAudio; editSpritesheet takes `spritesheet_url`), `num_frames`/`num_cols`/`num_rows` (the grid layout), and, when requested, `gif_url`, `individual_frame_urls` and `spritesheet_with_background_url`. The hydra, hydra-plus and ignis models also return `audio_url`, a sound effect for the animation - there is no need to call createSpriteAudio afterwards; the legacy forge and forge-pixel produce no audio. The chosen model must support sprite animation and the duration must be valid for it; incompatible model/duration combinations return HTTP 400. Credits are held for the duration you requested when the job is accepted; the final charge is rate × seconds of video generated (legacy models keep their minimum charge), never more than for the duration you requested, and the difference (or everything, if the job fails or is cancelled) is refunded. The returned sheet is then trimmed to its best loop and can run slightly shorter than the video; that trim is not deducted. Choosing a tool: animateSprite (this one) when you can describe the motion in text; transferMotion when you want an exact motion copied from a reference video or one of the named presets from listAnimationPres…

NameTypeReqDescription
requestBodyobjectyesPayload for generating an animated spritesheet from a static image. Input images can either be provided in base64 or URL. If the image was generated using Ludo, ideally it should be generated using t…

No output schema declared.

No examples provided.

animateSpriteKeyframes ~600

Animate a sprite through up to three fixed keyframes - initial_image, middle_image and final_image (each a URL or base64) - producing a spritesheet that interpolates through the provided frames in order. initial_image is required: the animation starts from it, and middle_image and final_image add keyframes after it (either may be omitted). The motion_prompt is optional here - when omitted, the motion is derived purely from the keyframes. Runs on hydra (default; also returns `audio_url`), hydra-plus (hydra with finer detail, also returns `audio_url`), ignis, or ignis-pixel for pixel-art sprites (forge and forge-pixel are legacy) - the models that support a middle keyframe; any other model returns HTTP 400. For just a start and end frame, animateSprite with `final_image` does the same job. The job result is the same sprite result as animateSprite (`spritesheet_url`, `video_url`, grid fields, optional GIF and frame URLs, `audio_url` on hydra, hydra-plus and ignis). Credits are held for the duration you requested when the job is accepted; the final charge is rate × seconds of video generated, never more than for the duration you requested, and the difference (or everything, if the job fails or is cancelled) is refunded. The returned sheet is then trimmed to its best loop and can run slightly shorter than the video; that trim is not deducted. Use animateSprite instead for the classic single-image + text-prompt animation. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type spritesheet). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: credits/s × seconds, per model: Hydra 3/s (shortest duration 3s, so 9 credits minimum), Griffin 10 flat, Ignis 1.5/s, Ignis Pixel 1.5/s, Hydra+ 4/s (shortest duration 3s, so 12 credits minimum) [LEGACY], Forge 1.5/s [LEGACY], Forge Pixel 1.5/s [LEGACY]; flat = credits per generation; [LEGACY] models are scheduled f…

NameTypeReqDescription
requestBodyobjectyesPayload for generating an animated spritesheet that interpolates through up to three fixed keyframes (initial / middle / final). Runs on hydra (default), hydra-plus, ignis or ignis-pixel (and the leg…

No output schema declared.

No examples provided.

attachDirectionalAccessories ~235

Put accessories on a rigged 3D model for Directional Sprites: up to 8 items, each at the `placement` fitDirectionalAccessory returned (or, without one, at the automatic fit plus the same size/move/turn adjustments). Returns `model_url`, one GLB of the model holding them all (kept 7 days): pass it as `model` to createDirectionalSprites, createDirectionalStills or previewDirectionalSprites. When `model` is the URL of one of your 3D models (as listGenerations or create3DModel returned it), the items are also saved on that model (`saved: true`; `save_on_model: false` skips it), so the Ludo web app's Directional Sprites shows them on it. Items the model already had saved stay on it and in the GLB (`kept`), except those held by a bone a new item takes; `keep_saved: false` replaces them all. Free (no credits) and synchronous.

NameTypeReqDescription
requestBody–yesPayload for putting accessories on a rigged 3D model

No output schema declared.

No examples provided.

cancelApiJob ~77

Cancel a queued job you started through the API or MCP; the credits held for it are refunded. Jobs that are already running cannot be canceled (409). Returns the canceled job. This is free (no credits).

NameTypeReqDescription
idstringyesThe job id returned by a generation call (its `id` in the 202 response).

No output schema declared.

No examples provided.

convertToPixelArt ~338

Convert an image to pixel art: any art, broken AI pixel art or pixel art comes back as pixel art at about the input's own size. Free (no credits) and synchronous: the call answers with the result directly, with no job to poll. `pixel_size` is the size of one pixel-art pixel, in the input's pixels: larger values give coarser art. Omit it to use the image's own pixel size, which only works on an image that already has a pixel grid - when none can be detected the call fails with HTTP 400 asking for a pixel_size. On an input already on a pixel grid, a pixel_size you pass snaps to whole steps of that grid. `palette_size` (2-256) caps the number of colours; omit it to keep the colours as they are. The response has the image `url`, the `pixel_size` used (fractional when it was detected) and the art's size in pixel-art pixels as `columns` and `rows`; resize the image to columns x rows with nearest-neighbour to get one image pixel per art pixel. The source image (URL or base64) is uploaded and validated, and one larger than 15MB is rejected with HTTP 400. The source is left as it is and the result is a new image. Limited to 20 calls per 5 minutes, 120 an hour and 1000 a day. Pass an optional request_id to tag the result for later retrieval via listGenerations (type image).

NameTypeReqDescription
requestBodyobjectyesPayload for converting an image to pixel art

No output schema declared.

No examples provided.

create3DModel ~470

Convert a source image into a textured 3D model (image-to-3D). The job result is a downloadable GLB model_url plus an array of snapshot image URLs rendered from different angles (handy for previews). model picks the generator: prop (default) is low-cost and suits everyday props and environment pieces; hero is far more detailed and accurate, for close-up assets, but slower and more expensive. image is the front view; with prop, pass an optional back_image (the same subject seen from behind) so the back of the model follows it instead of being invented - hero takes the front image only and rejects a back_image with HTTP 400. The image is converted as it is: to make a character image for it first, from a prompt or by redrawing your own image as a 3D render, use create3DModelImage. Flat 2D art (outlines and flat colours, no shading) can come back as a flat card instead of a solid model: redraw it with create3DModelImage first. Accepts optional mesh controls: target_num_faces (max triangle count, 1000-200000, default 50000), texture_size (1024 or 2048, default 2048), and texture_type ("pbr", "simple", or "none", default "pbr"). Pass rig true to also rig the model in the same call, with the general rig (joint_naming as in rigModel), ready for animate3DModelPreset or createDirectionalSprites; that adds the rigModel price, charged only when the result comes back rigged. Credits are held when the job is accepted and refunded if it fails or is cancelled. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type 3d). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 4 credits per call with model "prop" (default), 15 credits per call with model "hero"; rig true adds 1 credit when the model comes back rigged.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a 3D model from an image

No output schema declared.

No examples provided.

create3DModelImage ~297

Make a character image ready to turn into a 3D model, the first step of Directional Sprites on the web. Pass a prompt describing the character, your own image (URL or base64), or both. With an image, it is redrawn as a 3D render, and the prompt becomes the changes to make (e.g. "add a red cape and a sword"); leave the prompt out to keep the character as it is. A redraw is a new picture each time, so call again for another try. The job result is a single image result with a url (not an array): pass that url as create3DModel's image. create3DModel itself converts the image it is given as it is. A call with neither prompt nor image is rejected with HTTP 400, and an image larger than 15MB too. Credits are held when the job is accepted and refunded if it fails or is cancelled. Pass an optional request_id to tag the result so you can retrieve it later via listGenerations (type image). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result.

NameTypeReqDescription
requestBodyobjectyesPayload for making a character image ready for create3DModel. Pass a prompt, an image, or both.

No output schema declared.

No examples provided.

createAmbiance ~231

Produce a looping background ambiance soundscape from a text description, such as "windy forest at dusk" or "busy tavern interior". The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The description field is required and duration is capped at 10 seconds (0 means auto-pick based on the description). Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this for continuous, atmospheric background loops; use createSoundEffect for short discrete sound effects, createMusic for musical pieces, and createAudioTransform to remix an existing audio sample. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 2 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a seamless looping ambiance soundscape from a text description

No output schema declared.

No examples provided.

createAnimation ~502

Generate a reusable animation from a text prompt (text-to-motion): the skeletal motion of a humanoid character, such as "overhead sword slash" or "zombie walk", made for no model in particular. It is saved to the account and can then be played by any rigged humanoid 3D model or transferred onto any sprite. No model or sprite is animated by this call; to animate one rigged model straight from a prompt, use animate3DModel. The job result is an `animations` array, one animation per num_variants (each with its own seed), each with an `id`, a `name`, the `caption` the motion model was given, its `duration`, whether it loops, and a `preview_url`: an mp4 of the move on a mannequin, seen from the low camera facing SW. There is no GLB yet: use an animation's `id` as `animation_id` wherever an animation preset goes - animate3DModelPreset (retarget it onto a rigged GLB, which gives the GLB), createDirectionalSprites and previewDirectionalSprites (render it on a 3D model from up to 8 directions) and transferMotion (onto a 2D sprite, seen from a `perspective` and a `direction`). Animations stay on the account and do not expire: listMyAnimations finds them again, so generate a move once and reuse it on every character. Choosing a tool: look through listAnimationPresets first, since a preset is curated and ready to use; generate an animation when no preset covers the move. By default the prompt is rewritten for the motion model and every option left out (duration, loop, the idle ends, the hands, keep_facing) is inferred from it, so a short description in any language is enough; set augment_prompt to false only to write the motion model's prompt yourself, in the format that field gives. Credits are held for every variant asked when the job is accepted; the final charge is for the animations that came back, and everything is refunded if the job fails or is cancelled. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instruction…

NameTypeReqDescription
requestBodyobjectyesPayload for generating animations from a text prompt

No output schema declared.

No examples provided.

createAudioTransform ~323

Remix an existing audio sample (a sound effect, ambiance, or music clip) into a variation guided by a text prompt, for example turning a track into an 80s synthwave or metal version. Both the sample and the prompt are required; the sample is uploaded as a URL or base64 audio and must be at most 15MB or the call returns HTTP 400, and duration must be one of the allowed values (0 means match the source, otherwise multiples of 10 up to 180 seconds). The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The optional modification_strength (0 to 1, default 0.6) controls how far the result departs from the original, and loop set to true makes the result loop seamlessly. Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this to transform existing audio you already have; use createSoundEffect, createAmbiance, or createMusic to generate audio from scratch. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 3 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for remixing an audio sample (sound effect, ambiance or music) into a variation guided by a text prompt

No output schema declared.

No examples provided.

createDirectionalSprites ~392

Directional Sprites: render a 3D model into one spritesheet per direction, in a style. Pass the GLB in `model` (URL or base64; rigged, to animate it - see create3DModel with rig, or rigModel) and at most one animation: `animation_url` (the `glb_url` of an animation from animate3DModel or animate3DModelPreset, made for this model), `preset_id` (a preset from listAnimationPresets, retargeted onto the model; any rig type can take one, though retargeting does not succeed on every model, and when it does not the call returns an error) or `model_animation` (the name of an animation the GLB itself carries). With no animation each sheet is a single frame. `directions` are where the camera stands around a character facing S (up to 8); every direction is rendered together, on the same frame size, scale and floor, so the sheets line up. Pick the style with listDirectionalSpriteStyles (style_id, and style_params for its settings) and check it with previewDirectionalSprites first. The job result is one sheet per direction, in the order asked, each with its `spritesheet_url`, grid fields, fps and `render_3d`. Credits are held for every direction when the job is accepted and charged for the sheets that come back; a failed or cancelled job is refunded. Pass an optional request_id to tag the sheets for later retrieval via listGenerations (type spritesheet). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 1 credit per direction (one sheet each).

NameTypeReqDescription
requestBodyobjectyesPayload for rendering a 3D model as directional sprite sheets

No output schema declared.

No examples provided.

createDirectionalStills ~234

Directional Sprites stills: render a 3D model as it is (no animation) into one large image per direction, in a style, on a transparent background. Pass the GLB in `model` (URL or base64), the `directions` (up to 8, rendered together so they line up) and the style (listDirectionalSpriteStyles). Each still is a sprite image you can animate with animateSprite or edit with editImage. The job result is one image per direction, in the order asked. Credits are held for every direction when the job is accepted and charged for the images that come back; a failed or cancelled job is refunded. Pass an optional request_id to tag the images for later retrieval via listGenerations (type image). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per direction (one image each).

NameTypeReqDescription
requestBodyobjectyesPayload for rendering a 3D model as one still image per direction

No output schema declared.

No examples provided.

createImage ~238

Generate game-art images from a text prompt alone, selecting an image_type (e.g. sprite) and optionally art_style, perspective, and aspect_ratio. The job result is an array of image results, each with a url; request n (1-8) to control how many variations come back. Because it generates purely from text it takes no source image, so there is no upload size limit to trip. Credits are held when the job is accepted and refunded if it fails or is cancelled; the charge scales with the number of images produced. Use createImage to make new images from scratch; use generateWithStyle to match a reference image's art style, editImage to modify an existing image, and removeBackground to cut out a subject. Pass an optional request_id to tag the results so you can retrieve them later via listGenerations (type image). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result.

NameTypeReqDescription
requestBodyobjectyesPayload for generating an image from text prompt

No output schema declared.

No examples provided.

createMusic ~256

Produce a piece of music from a text description, such as "epic orchestral battle theme" or "calm piano melody", with optional lyrics. The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The description field is required; duration must be one of the allowed values (0 means auto, otherwise multiples of 10 up to 180 seconds) and out-of-range values return HTTP 400. Set loop to true for a seamlessly looping piece. Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this for songs and musical scores; use createSoundEffect for short sound effects, createAmbiance for looping background soundscapes, and createAudioTransform to remix an existing audio sample. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 3 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for generating music from a text description

No output schema declared.

No examples provided.

createNormalMap ~242

Make the normal map of an image, for 2.5D lighting: a lossless WebP of the same size and alpha as the image (transparent pixels are flat), in the OpenGL convention (red = right, green = up, blue = towards the viewer; Unity and Godot read it as is, Unreal expects green flipped). Pixel art gets one normal per art pixel, and the map of a seamless tile tiles the same way. An image you generated on Ludo is read with its type and pixel grid; for any other image pixel art is detected. Free, and limited to 20 calls per 5 minutes, 120 an hour and 1000 a day (HTTP 429 beyond). To get maps with new images or spritesheets, pass save_normals: true to the generation instead. The image is uploaded and validated, and an image larger than 15MB is rejected with HTTP 400. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions).

NameTypeReqDescription
requestBodyobjectyesPayload for making the normal map of an image

No output schema declared.

No examples provided.

createSoundEffect ~242

Produce a short sound effect (SFX) from a text description, such as "laser gun firing" or "footsteps on gravel". The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The description field is required, duration is capped at 10 seconds (0 means auto-pick based on the description), and you may set loop to true for a seamlessly looping effect. Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this for short, discrete sounds; use createAmbiance for a continuous looping background soundscape, createMusic for musical pieces, and createAudioTransform to remix an existing audio sample. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 2 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a sound effect from a text description

No output schema declared.

No examples provided.

createSpeech ~277

Convert text to speech by cloning the voice from an audio sample you provide (voice-cloning text-to-speech). Both text and sample are required; the text is limited to 250 characters and the sample is supplied as a URL or base64 audio that must be at most 15MB, with violations returning HTTP 400. An optional delivery note (at most 50 characters, e.g. "angry, shouting") says how the line is said. The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this when you have a reference voice sample to clone; use createSpeechPreset to speak with a built-in named preset voice instead, and createVoice to design a brand-new voice from a text description rather than cloning one. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 2 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for text-to-speech generation using voice cloning

No output schema declared.

No examples provided.

createSpeechPreset ~313

Convert text to speech using a named built-in preset voice, with optional language and either an emotion or a delivery note, depending on the voice. Both text and voice_preset_id are required and the text is limited to 250 characters. The voices named by a first name (e.g. "Rachel") take a delivery note (at most 50 characters, e.g. "angry, shouting") and no emotion; the descriptive voices (e.g. "Serious woman") take an emotion and no delivery note. Invalid input, including an emotion or delivery note the voice does not take, returns HTTP 400. The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this when you want a ready-made catalog voice and do not need to supply your own sample; use createSpeech to clone a voice from an audio sample instead, and createVoice to design a new voice from a text description. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 1 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for text-to-speech generation using a voice preset

No output schema declared.

No examples provided.

createSpriteAudio ~304

Generate a sound effect for a previously generated spritesheet animation. Pass, as `spritesheet_video_url`, the `video_url` you received from `animateSprite`, `animateSpriteKeyframes`, `transferMotion`, or `editSpritesheet` - it must belong to a spritesheet you generated within the last 7 days; arbitrary external videos are not accepted. Spritesheets generated with the hydra or ignis models already come with `audio_url`, so only call this for a spritesheet that has none or to replace the generated sound. Optionally add a `prompt` describing the sound you want. The job result is only the URL of the generated audio file, an MP3 or WAV (the URL's extension, .mp3 or .wav, says which); no video is returned. The audio is also attached to the spritesheet, so it appears as `audio_url` in listGenerations (type spritesheet), where the spritesheet keeps the `request_id` it was generated with. Pass an optional `request_id` to make this call idempotent and to find its job again; it must not be one you already used for another generation. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 3 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for generating audio for a previously generated spritesheet animation.

No output schema declared.

No examples provided.

createTile ~376

Make a seamless base tile for a 2D map from a text description: the first step of a tileset. Choose the map's grid (square for top-down, diamond for 2:1 isometric, diamond-true for true isometric) and what to make with image_type: texture (the default) is a ground that repeats with no seams, one per terrain (grass, sand, cobblestones, water); sprite-tiling-horizontal and sprite-tiling-vertical are a strip of a line that repeats along it (a road, a river, a fence, a wall) on a transparent background, and scatter-pattern the separate elements a line is made of (rocks, bushes, flowers). The look comes from art_style or from a reference_image (URL or base64), which replaces the art style. The job result is an array of tiles, each with its url, the image type the tile came back with and the grid it was made for; request n (1-4) for more candidates. Pass a tile's url as tile_a or tile_b of createTileset on the same grid to build a 16-tile set from it. For a single seamless texture that is not for a tileset, use createImage with image_type texture instead. Credits are held when the job is accepted and refunded if it fails or is cancelled; the charge scales with the number of tiles produced. Pass an optional request_id to tag the results so you can retrieve them later via listGenerations (type tile). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result.

NameTypeReqDescription
requestBodyobjectyesPayload for making a seamless base tile

No output schema declared.

No examples provided.

createTileset ~519

Build a 16-tile tileset from seamless base tiles: every arrangement a map needs, so the edges and corners fall into place when a map is painted with it. kind terrain (the default) blends terrain A (tile_a, required) into terrain B (tile_b; leave it out and the tiles are cut out there, transparent, for floors over a void or islands), with the boundary described in transition (e.g. white sea foam, a low stone curb): its 16 tiles cover every way the two terrains meet at a tile's four corners. kind lines lays a line (tile_b, required: a strip or scatter made by createTile, or a ground tile of the line's material) over a ground (tile_a, optional: without it the set is a transparent overlay), in every dead end, straight, turn, T and crossing: its 16 tiles cover every way the line leaves a tile by its four sides. Both tiles must be for the set's grid. Pass tiles as the url createTile returned (the tile is then read with its type, which gives the best result) or as any image by URL or base64, uploaded and limited to 15MB; an image that does not repeat seamlessly is rejected. shape sets the outline of the boundary and save_normals adds a normal map of the whole atlas. The job result is one tileset: atlas_url (a 4 x 4 atlas of the 16 tiles, each tile_width x tile_height), normal_map_url when asked, and tiles, each with its row and column on the atlas and its corner terrains or line sides, which is what an engine's autotile or terrain setup is built from. In Godot, a terrain set's tiles match by corners and a line set's by sides; fill the map with one terrain's full tile first, then paint the other, since a set has no tile for a terrain next to an empty cell. Change a whole set afterwards with editTileset. Credits are held when the job is accepted and refunded if it fails or is cancelled. Pass an optional request_id to tag the result so you can retrieve it later via listGenerations (type tileset). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit…

NameTypeReqDescription
requestBodyobjectyesPayload for building a 16-tile tileset from seamless base tiles

No output schema declared.

No examples provided.

createTopupLink ~112

Buy extra credits: a Stripe payment page for that many credits, for the user to open and pay (show them the checkout_url). Nothing is charged until they pay, never the card saved on the account, and the credits are added the moment they do; getTopupLink says when. One page is open at a time (replace: true ends the open one). Use it when the user is out of credits and asks to buy more. Free to call.

NameTypeReqDescription
requestBodyobjectyes–

No output schema declared.

No examples provided.

createVideo ~439

Generate a short video clip from a source image and a motion text prompt (image-to-video); a source `image` is required - to make a video from text alone, first createImage and animate that, or use createVideoFromReferences with reference images. Griffin (default, 768p) generates a soundtrack; no separate audio step is needed. The older 480p model (`griffin`) has been retired from this endpoint. The job result is the video URL and its actual duration in seconds. 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 held when the job is accepted; the final charge is rate × produced seconds, never more than for the duration you requested, and the difference (or everything, if the job fails or is cancelled) is refunded. Pass an optional `request_id` to tag the result so you can locate it later via listGenerations (type video). Related tools: use `createImage` for static images, `animateSprite` for sprite-sheet animation, and listGenerations (type video) to list videos you generated earlier. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: credits/s × seconds, per model: Griffin 2/s (shortest duration 5s, so 10 credits minimum), Ignis 1/s (shortest duration 3s, so 3 credits minimum), Blitz 1/s (shortest duration 2s, so 2 credits minimum) [LEGACY], Eagle 1.3/s [LEGACY], Eagle with Audio 1.8/s [LEGACY]; [LEGACY] models are scheduled for removal - do not use them for new work; see this endpoint's full pricing table in the API docs.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a video from a source image and motion prompt

No output schema declared.

No examples provided.

createVideoFromReferences ~384

Generate a video from 1-5 reference images and a text prompt (references-to-video). Unlike createVideo, which animates a single source image, this composes a new scene that borrows characters, objects, and style from the reference images. Each image can be a URL or base64. Griffin (default, 768p) generates a soundtrack, at the same per-second rate as createVideo. The older 480p model (`griffin`) has been retired from this endpoint. The job result is the video URL and its actual duration in seconds. Choose the output shape with `aspect_ratio` ("default" lets the model decide). The chosen `model` and `duration` must be compatible (incompatible combinations return HTTP 400). Credits are held when the job is accepted; the final charge is rate × produced seconds, never more than for the duration you requested, and the difference (or everything, if the job fails or is cancelled) is refunded. Pass an optional `request_id` to tag the result so you can locate it later via listGenerations (type video). Related tools: `createVideo` for image-to-video, `editVideo` to modify a generated video. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: credits/s × seconds, per model: Griffin 2/s (shortest duration 5s, so 10 credits minimum), Eagle 1.5/s [LEGACY], Eagle with Audio 2/s [LEGACY]; [LEGACY] models are scheduled for removal - do not use them for new work; see this endpoint's full pricing table in the API docs.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a video from 1-5 reference images and a text prompt.

No output schema declared.

No examples provided.

createVoice ~301

Design a new voice from a character description (such as "deep-voiced warrior" or "cheerful young girl"), a character image, or both, and have it speak a short line of text, returning a sample of that newly created voice. text is required, plus voice_description or image (an image of the speaking character, given as a URL or base64, makes the description optional); the spoken text is limited to 100 characters or the call returns HTTP 400, and type selects "human" or "non-human" voices. The job result is a single audio result containing the URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). Credits are held when the job is accepted and refunded if it fails or is cancelled. Use this to invent and audition a voice from a description; use createSpeech for text-to-speech that clones a specific voice from an audio sample, and createSpeechPreset for text-to-speech using a named preset voice. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type audio). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 2 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a voice sample from a character description and/or a character image

No output schema declared.

No examples provided.

editImage ~375

Modify an existing image according to text instructions: supply a source image (URL or base64) and a prompt describing the changes (e.g. "add clouds", "warmer color scheme"), with an optional reference_image for extra style or content guidance. To change only one area, pass a mask (white = change, black = keep, the same size as the image): mask_mode "replace" (default) redraws that area from the prompt, "erase" removes what is there. Without a mask the whole image is re-rendered. Never ask for a transparent background in the prompt: it often comes back as a grey-and-white checkerboard painted into the pixels, which removeBackground cannot remove. A sprite keeps its transparency without being asked (see image_type). The job result is an array of image results, each with a url; request n (1-4) to control the number of edited variations. Provided images are uploaded and validated, and any image larger than 15MB is rejected with HTTP 400. Credits are held when the job is accepted and refunded if it fails or is cancelled; the charge scales with the number of images produced. Use editImage to transform a specific existing image; use createImage to generate from text alone, generateWithStyle to borrow a reference's art style, and removeBackground for the dedicated background-removal case. Pass an optional request_id to tag the results so you can retrieve them later via listGenerations (type image). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result; 1 credit per result with a mask.

NameTypeReqDescription
requestBodyobjectyesPayload for editing an existing image based on text instructions

No output schema declared.

No examples provided.

editSpritesheet ~729

Edit a previously generated spritesheet: re-prompt its underlying animation (edit_mode "prompt"), extend the frame beyond its borders ("outpaint"), repair a bad loop ("fix_loop"), or re-render it with finer detail ("improve": the extra pass hydra-plus runs when it generates, on a spritesheet generated with hydra only - any other returns HTTP 400; a sheet generated on hydra-plus already has it). Pass the `spritesheet_url` you received from `animateSprite`, `animateSpriteKeyframes`, `transferMotion`, or an earlier edit - it must be a spritesheet you generated within the last 7 days; arbitrary external images are not accepted. Omit `duration`, `frames`, `frame_size`, `crop` and `model` to keep the source spritesheet's values. A `prompt` is required for edit_mode "prompt", optional for "outpaint", and not accepted for "fix_loop" or "improve"; optionally add up to 5 reference `images` (URL or base64) to guide the edit. The job result is the same result shape as animateSprite (spritesheet URL, frame layout, optional GIF or individual frames). Credits are held when the job is accepted; the final charge is rate × seconds of video generated, never more than was held, and the difference (or everything, if the job fails or is cancelled) is refunded. The returned sheet is then trimmed to its best loop and can run slightly shorter than the video; that trim is not deducted. Prompt edits are priced per model (credits/second × duration) and held for the duration you requested; "outpaint", "fix_loop" and "improve" run a lighter pipeline in which `model` is ignored and are billed at a flat 1 credit per second of output, held for and capped at the length of the source spritesheet's video (`duration` does not change their price). Outpaint decides the extra margin itself - there is no amount parameter. The result carries the same fields as animateSprite (`spritesheet_url`, `video_url`, grid fields); new audio is generated only by prompt edits on hydra: "fix_loop", "outpaint" and "impro…

NameTypeReqDescription
requestBodyobjectyesPayload for editing a previously generated spritesheet. edit_mode selects the operation - prompt-driven edit (default), outpaint, loop fixing, or improve (finer detail, on hydra spritesheets only).

No output schema declared.

No examples provided.

editTileset ~242

Change a whole tileset with one sentence: its look (cover the ground in snow, at sunset, another art style) or its boundary (replace the curb with a hedge). The set is one you made with createTileset or in the Ludo web app, given by its atlas_url; any other URL is rejected with HTTP 404 before credits are held. The result is a new tileset of the same grid and kind whose 16 tiles fit together the same way, so it drops into a map painted with the original; the original is kept. save_normals adds a normal map of the new atlas. The job result has the same shape as createTileset's. Credits are held when the job is accepted and refunded if it fails or is cancelled. Pass an optional request_id to tag the result so you can retrieve it later via listGenerations (type tileset). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 1 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for editing a whole tileset

No output schema declared.

No examples provided.

editVideo ~332

Edit a previously generated video with a text prompt and optional reference images (video-to-video); runs on griffin-hd (768p, with soundtrack) and the output keeps the source video's duration unless you pass one. Pass the video `url` you received from `createVideo`, `createVideoFromReferences`, or an earlier edit - it must be a video you generated within the last 7 days; arbitrary external videos are not accepted. Optionally add up to 5 reference `images` (URL or base64) to guide the edit. The job result is the new video URL and its actual duration in seconds. Credits are held when the job is accepted; the final charge is rate × produced seconds, never more than for the duration you requested, and the difference (or everything, if the job fails or is cancelled) is refunded. Pass an optional `request_id` to tag the result so you can locate it later via listGenerations (type video). Related tools: `createVideo` to generate the source clip, `createVideoFromReferences` for reference-driven generation. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: credits/s × seconds, per model: Griffin 2/s, Eagle 2/s [LEGACY]; [LEGACY] models are scheduled for removal - do not use them for new work; see this endpoint's full pricing table in the API docs.

NameTypeReqDescription
requestBodyobjectyesPayload for editing a previously generated video with a text prompt and optional reference images.

No output schema declared.

No examples provided.

fitDirectionalAccessory ~371

Fit an accessory to a rigged 3D model for Directional Sprites: an item GLB (a sword, a gun, a staff, a bow, a shield, a helmet, a hat, a backpack...) held by one bone of the model - a hand, the head, the back or the hips. Nothing is saved. The item is first placed automatically for its `kind` (a sword by its handle, a gun by its pistol grip, a shield on the forearm, a helmet over the head, a backpack on the back), and the hand closes round it. Adjust it relative to that automatic fit with `size` (% of it), `move` (% of the character's height along forward/up/out) and `turn` (degrees about those axes), and call again with the new values until it looks right: each call starts from the automatic fit, so send the full adjustment every time. The response has the `placement` to pass to attachDirectionalAccessories, `checks` (how far the item sinks into the body, how far its grip is from the palm, how much of the head pokes through a helmet, each in % of the character's height or of its vertices), and, unless `preview` is false, `model_url` (the model holding the item, a GLB kept 7 days) and `previews`: frames of the model walking with it, seen from SW and SE, like previewDirectionalSprites' (which this shares: one preview at a time, a newer one cancels the older, which then comes back without previews). Free (no credits) and synchronous; a fit takes a few seconds with previews.

NameTypeReqDescription
requestBody–yesPayload for fitting an accessory to a rigged 3D model

No output schema declared.

No examples provided.

generatePose ~278

Re-pose an existing sprite into a new target pose while preserving the character, taking a source image (URL or base64), a pose name (or "Other" with a free-text description), and an optional n (1-4) for how many variations to produce. Only works with sprite image types (not icons, screenshots, etc.). The job result is an array of pose results, each containing the generated image url, the pose and description used, and a suggested motion_prompt tuned for that pose. Credits are held when the job is accepted and refunded if it fails or is cancelled; the charge scales with the number of images generated. This is typically the first step before animating: call generatePose to set the character's pose, then feed the result (and its suggested motion_prompt) into animateSprite for the best animation quality; use rotateSprite instead when you want to change the camera angle rather than the pose. Pass an optional request_id to tag the results so you can locate them later via listGenerations (type spritesheet). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result.

NameTypeReqDescription
requestBodyobjectyesPayload for generating a new pose for an existing sprite

No output schema declared.

No examples provided.

generateWithStyle ~255

Generate new images that match the visual style of a reference image: supply a style_image (URL or base64) plus a text prompt describing what to create and an optional image_type (defaults to sprite). The job result is an array of image results, each with a url; request n (1-4) to control the number of variations. The style_image is uploaded and validated, and an image larger than 15MB is rejected with HTTP 400. Credits are held when the job is accepted and refunded if it fails or is cancelled; the charge scales with the number of images produced. Use this instead of createImage when style consistency with an existing asset matters; use editImage to alter the content of a specific image rather than borrow its style, and removeBackground to isolate a subject. Pass an optional request_id to tag the results so you can retrieve them later via listGenerations (type image). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result.

NameTypeReqDescription
requestBodyobjectyesPayload for generating new content while maintaining the visual style of a reference image

No output schema declared.

No examples provided.

getAccount ~131

Show your account's credit balance, plan and auto top-up settings. `credits.available` is what generations can spend right now (plan_credits + extra - used); `resets_at` is when the plan's monthly credits refill (unix seconds). When `team_pool` is true the balance is your team's shared pool, and `auto_topup` is null because the team owner manages it. Check this before an expensive generation instead of waiting for a 402. Auto top-up is changed in the web app at `billing_url`. This is a free read-only lookup (no credits, no generation).

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

getApiJob ~163

Poll the status of a generation job started by any tool. Every generation tool returns `{id, status}`; call getApiJob with that id until status is `succeeded` (then read `result`, shaped exactly like the tool's documented output) or `failed` (read `error`). Poll every few seconds, or pass `wait: 30` to long-poll - the call is held up to 30 seconds (max 60) and returns as soon as the job finishes.

NameTypeReqDescription
idstringyesThe job id returned by a generation call (its `id` in the 202 response).
waitinteger–Seconds to long-poll for a terminal state (0-60). Defaults to 0 (return immediately).

No output schema declared.

No examples provided.

getDocs ~411

Browse or read Ludo's own documentation in full - how to choose a sprite animation mode, when to use Generate Before / Generate After, how margins behave, which model suits a job, and each generator's known limitations. To answer a specific question, call searchDocs first: it returns just the sections that match. Use getDocs to see what documentation exists, or to read a whole document or named sections. This is the same documentation the Ludo web app shows its users, so it occasionally describes buttons rather than parameters; the substance applies to the API and MCP surfaces just the same. To browse, call it with NO parameters to get a table of contents - every document with its id, label and section titles, and no bodies - then call it again with `doc` (and optionally `sections`) to read only what you need. Fetching a whole document can return tens of thousands of characters, so prefer naming the sections, using titles copied from the table of contents. Section titles match ignoring case, spacing and punctuation: when only some requested titles exist you receive those sections plus `unmatched_sections` and `available_sections`, and when none exist (or `doc` is unknown) the call returns 400 listing the valid values so you can retry once. This is a free discovery endpoint: it does not charge credits and does not queue a job.

NameTypeReqDescription
docstring–Which document to read, by id (the table of contents returned by the no-parameter call lists them). Omit to receive the table of contents.
sectionsarray–Section titles to return from `doc`, copied from the table of contents (an array of titles; over plain REST, a comma-separated string, where a title that itself contains a comma is still matched whol…

No output schema declared.

No examples provided.

getPricing ~213

What Ludo's paid service costs and includes, for an agent advising a user: every plan with its monthly and annual price, credits, seats, queue concurrency and what it includes or lacks; credit top-ups and their price brackets; what each API call costs; and the rules to know before telling a user to pay. The ones that matter most: the API, MCP and CLI need an active paid plan (the free trial gets 402 on every other call), and there every generation costs credits - "unlimited" on Pro and Studio is the web app only. Plans are changed in the web app (`links.billing`); extra credits can be bought through the top-up endpoints (getTopupQuote), and someone with no account can subscribe from the CLI (`ludo signup`). Plans, prices and rules here are the live ones, the same as https://ludo.ai/pricing. This is a free lookup (no credits, no job) and works with or without an API key, on any plan.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

getTopupLink ~62

Where a payment page from createTopupLink is: open (not paid yet), paid (credits on their way), completed (the credits are in the account) or expired (never paid). Free, read-only.

NameTypeReqDescription
session_idstringyes–

No output schema declared.

No examples provided.

getTopupQuote ~112

The price of a credit top-up (extra credits that stay while the plan is active) on your plan, and the one-time Link (`link-cli`) spend request to pay it without a browser. `credits` goes in steps between min_credits and max_credits. Free, read-only. Buying: createTopupLink (a payment page for the user to pay), or payTopup with a Link token. Never buy credits the user did not ask for.

NameTypeReqDescription
creditsintegeryes–

No output schema declared.

No examples provided.

listAnimationPresets ~198

List the available animation presets along with their perspectives and the eight supported compass directions (N, NE, E, SE, S, SW, W, NW). Synchronous GET with no request body: it returns an animations array (each with id, name, category, description, duration, and preview_url), a deduplicated perspectives array, and the directions list. This is a free discovery endpoint and does not charge credits. Use it to obtain the preset_id, perspective, and direction values that transferMotion needs, and to find motion preset names you can reference when animating; pair it with transferMotion (to apply a preset onto a sprite), animateSprite (text-prompt animation), or animate3DModelPreset (apply any preset by id to a rigged 3D model). When no preset covers the move, createAnimation generates one from a text prompt, used by `animation_id` wherever a preset_id goes.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

listApiJobs ~116

List the generation jobs you started through the API or MCP, most recent first. Web-app jobs are not included. This is a free read-only lookup (no credits, no generation). Filter with a comma-separated status list; limit defaults to 50 and is capped at 100.

NameTypeReqDescription
limitinteger–Maximum number of jobs to return. Defaults to 50, capped at 100.
statusstring–Comma-separated statuses to include (queued, running, succeeded, failed, canceled). Defaults to all.

No output schema declared.

No examples provided.

listDirectionalSpriteStyles ~159

List the styles Directional Sprites can render a 3D model in, with the perspectives (camera heights) and the eight directions they render from. Each style has an id (pass it as style_id), a label, a description, a family, whether it is pixel art, a thumbnail_url of the style at its defaults, its current version, and its settings: each setting has a name (the key in style_params), a kind (choice, bool or color - a color setting also takes any colour), its options ({label, value}) and its default. advanced_settings work the same way. Free discovery endpoint: it does not charge credits. Use it before previewDirectionalSprites, createDirectionalSprites and createDirectionalStills.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

listGenerations ~308

List your generation history across the API and the web app - filter by type, source (api|web|all), text search, and date range. Returns {items, page, page_size, has_more}; keep paging while has_more is true. API-originated results expire after 7 days - download anything you want to retain. For an in-flight job's status use getApiJob instead.

NameTypeReqDescription
date_frominteger–Only return items generated at or after this time (unix seconds)
date_tointeger–Only return items generated at or before this time (unix seconds)
page_numberinteger–1-based page number Default: 1.
page_sizeinteger–Items per page (1-100) Default: 20.
request_idstring–Only return items tagged with this request_id when you generated them
searchstring–Free-text search. Every whitespace-separated term must match (case-insensitive substring) the item's tags or one of its text fields (prompt, hints, style, label, ...), so "dwarf axe" narrows to items…
sourcestring–Which surface the items were generated from: api (your API/MCP generations, last 7 days only), web (your Ludo web studio generations, no time limit), or all (default, both) Default: "all".
typestringyesWhich kind of generation to list

No output schema declared.

No examples provided.

listMyAnimations ~269

List the account's own animations: the ones generated with createAnimation or in the web app's My Animations, newest first. (Ludo's ready-made ones are listAnimationPresets.) Synchronous GET with no request body: it returns an `animations` array, each with the `id` to pass as `animation_id`, its `name`, the `prompt` it was generated from, its `duration`, whether it loops, and a `preview_url` (an mp4 of the move on a mannequin). Animations do not expire, so call this before generating a move again: one made earlier, for another character or in the web app, can be reused as it is. Pass an animation's `id` as `animation_id` to animate3DModelPreset, createDirectionalSprites, previewDirectionalSprites or transferMotion. 50 animations per call by default; for older ones pass `before` with the `created_at` of the last animation received. This is a free endpoint and does not charge credits.

NameTypeReqDescription
beforeinteger–Only animations created before this time (unix seconds) - the `created_at` of the last animation of the previous call.
limitinteger–How many animations to return, newest first. Default: 50.

No output schema declared.

No examples provided.

payTopup ~104

Buy extra credits with a one-time Link Shared Payment Token (spt_...) the user approved in Link for exactly the amount getTopupQuote gives; when it answers "completed" the credits are in the account ("paid": they are on their way). For agents that run Link's CLI; otherwise use createTopupLink. A token buys one top-up. Only when the user asked for the credits and approved the payment.

NameTypeReqDescription
requestBodyobjectyes–

No output schema declared.

No examples provided.

previewDirectionalSprites ~225

Preview Directional Sprites: a few frames of a 3D model in a style, from each direction asked for, to check a style before rendering. Takes the same model, animation, camera and style fields as createDirectionalSprites. The response (synchronous, not a job) has one preview per direction, in the order asked, each with `frame_urls` - the frames as images (4 for an animated model, 1 for a still one) - and `render_3d`, the style and settings as rendered, which createDirectionalSprites takes back as they are. Free (no credits), and nothing is saved to your generations; the frame images are kept for 7 days. A preview takes several seconds. You run one preview at a time: starting another while one is still running cancels the older one, which then answers 204 with no body. Preview one or two directions while trying styles and render only once the look is right.

NameTypeReqDescription
requestBodyobjectyesPayload for previewing directional sprite frames of a 3D model

No output schema declared.

No examples provided.

removeBackground ~268

Remove the background from a single image, returning the subject isolated on a transparent background. Supply the source image (URL or base64); optionally set crop to trim the result to the content, and creative_edit (default true) for higher-quality output that may not match the input pixel-for-pixel - set it false when the subject must stay pixel-identical, e.g. an existing sprite you will animate. The job result is a single image result with a url (not an array). The image is uploaded and validated, and an image larger than 15MB is rejected with HTTP 400. Credits are held when the job is accepted and refunded if it fails or is cancelled. Use removeBackground for this dedicated cutout task; editImage can also remove backgrounds via a prompt but is better for broader edits, while createImage and generateWithStyle produce new images rather than process an existing one. Pass an optional request_id to tag the result so you can retrieve it later via listGenerations (type image). Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 0.5 credits per result.

NameTypeReqDescription
requestBodyobjectyesPayload for removing the background of an image

No output schema declared.

No examples provided.

rigModel ~319

Rig a 3D model: generate a skeleton and skin weights for an existing GLB so it can be animated. Accepts a URL or base64-encoded GLB in `model` (here `model` is the 3D asset file, not an AI model name - rigging has no model choice). The job result is a downloadable `model_url` for the rigged GLB. rig_type selects the skeleton prior - general (default, any asset), humanoid (anime-style characters), game (classic game-character rigs), or the pinned humanoid templates for two-armed, two-legged characters: humanoid_template (standard 22-joint skeleton with named joints) and humanoid_template_hands (52 joints, five fingers per hand). Animation presets retarget onto any rig type, though not onto every model. joint_naming relabels the identified joints to a convention - smpl (default), mixamo, humanik, unreal, godot, rigify, or vroid - without changing the skeleton. Credits are held when the job is accepted and refunded if it fails or is cancelled. Rigging is non-destructive to geometry but replaces any prior skeleton, so animations made against an old rig no longer apply. Async generation job: returns `{id, status}` - poll `getApiJob` (job and credit contract: see the server instructions). Credits: This endpoint consumes 1 credits per call.

NameTypeReqDescription
requestBodyobjectyesPayload for rigging a 3D model with a skeleton

No output schema declared.

No examples provided.

Install

How do I install the Ludo AI Game Assets MCP server?

Ludo AI Game Assets is a hosted endpoint at https://mcp.ludo.ai/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · mcp.ludo.ai

# add to Claude Code
claude mcp add --transport http ai-ludo-game-assets 'https://mcp.ludo.ai/mcp'
Common questions

What is the Ludo AI Game Assets MCP server?

Ludo AI Game Assets is an MCP server listed in the public MCP registry as ai.ludo/game-assets. Generate game assets with AI: sprites, animations, 3D models with rigging, video, music, SFX, voices. This page covers its hosted endpoint (https://mcp.ludo.ai/mcp).

Is the Ludo AI Game Assets MCP server safe to use?

Ludo AI Game Assets scores 75 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Ludo AI Game Assets MCP server expose?

Ludo AI Game Assets exposes 58 tools: validateApiKeyEndpoint, createImage, generateWithStyle, editImage, animateSprite, and 53 more. Their descriptions and schemas cost roughly 17,871 tokens of context every time the server is loaded.

Does the Ludo AI Game Assets MCP server require authentication?

No. We connected to Ludo AI Game Assets without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the Ludo AI Game Assets MCP server still maintained?

Ludo AI Game Assets is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What did VerifyMCP test on the Ludo AI Game Assets MCP server?

VerifyMCP ran 13 checks on Ludo AI Game Assets, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.