Ludo AI Game Assets

 ⟨9 unchanged words⟩  for an existing sprite","properties":{"augment_prompt":{"description":"Rewrites your prompt behind the scenes into the form the model works best with. Leave it on (the default). Turning it off does not give you more control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type":"boolean"},"description":{"description":"Optional additional instructions or ⟨174 unchanged words⟩ 

 ⟨9 unchanged words⟩  of an existing sprite","properties":{"augment_prompt":{"description":"Rewrites your prompt behind the scenes into the form the model works best with. Leave it on (the default). Turning it off does not give you more control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type":"boolean"},"camera_elevation":{"description":"Optional camera elevation/tilt in ⟨151 unchanged words⟩ 

 ⟨137 unchanged words⟩  also rig the model in the same call, (rig_typewith andthe general rig (joint_naming as in rigModel), ready for animate3DModelPreset  ⟨101 unchanged words⟩ 

 ⟨245 unchanged words⟩ and skin weights) in the same call, as rigModel would, so it can be animated or rendered with createDirectionalSprites. Adds the rigModel price, charged only when the model comes backIt riggedgets (the result's rigged). Default: false.","example":false,"type":"boolean"},"rig_type":{"description":"Withgeneral rig, which skeleton tosuits buildany (asshape; rigModel'sthere rig_type).is humanoid_templateno (default,rig 22type joints)to andpick humanoid_template_handshere (52, fiverigModel fingersoffers perthe handothers) suit two-armed, two-legged characters; general suits any shape.. AnimationAdds presetsthe andrigModel createDirectionalSprites'price, preset_idcharged retargetonly ontowhen anythe ofmodel them,comes thoughback notrigged onto(the everyresult's model.rigged). Default: \"humanoid_template\".","enum":["general","humanoid","game","humanoid_template","humanoid_template_handsfalse."],"example":"humanoid_template"false,"type":"stringboolean"},"target_num_faces":{"description":"Maximum triangle ⟨55 unchanged words⟩ 

 ⟨37 unchanged words⟩ ,"sprite-generator","audio-generator","api-mcp","game-asset-generation","directional-sprites"],"type":"string"},"sections":{ ⟨76 unchanged words⟩ 

 ⟨38 unchanged words⟩  (from listAnimationPresets; any preset id works). TheAny modelrig musttype havecan take a humanoid-templatepreset, rigthough (rigretargeting does not succeed on every model: when it withdoes rig_typenot, humanoid_templatethe orjob humanoid_template_hands).fails. The job result is one retargeted animation - ⟨104 unchanged words⟩ 

 ⟨69 unchanged words⟩ not an AI model name). Rig it first, with rigModel usingor rig_typewith humanoid_templatecreate3DModel's orrig humanoid_template_hands(any first.rig type).","example":"<url> OR data:model/gltf-binary;base64,... ⟨59 unchanged words⟩ 

 ⟨303 unchanged words⟩  humanoid_template_hands (52, five fingers per hand) aresuit thetwo-armed, onestwo-legged animationcharacters; general suits any shape. Animation presets and createDirectionalSprites' preset_id need,retarget andonto onlyany suitof two-armedthem, two-legged characters; use generalthough fornot creaturesonto andevery objects.model. Default: \"humanoid_template\".","enum":[ ⟨68 unchanged words⟩ 

 ⟨54 unchanged words⟩  preset from listAnimationPresets, retargeted onto the model; needsany arig humanoid_templatetype orcan humanoid_template_handstake rigone, 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 ⟨159 unchanged words⟩ 

 ⟨365 unchanged words⟩  id from listAnimationPresets, retargeted onto the model. TheAny modelrig needstype acan humanoid_templatetake orone; humanoid_template_handswhen rig.the preset cannot be retargeted onto the model, the call returns an error. At most one of animation_url, preset_id and  ⟨147 unchanged words⟩ 

 ⟨255 unchanged words⟩  id from listAnimationPresets, retargeted onto the model. TheAny modelrig needstype acan humanoid_templatetake orone; humanoid_template_handswhen rig.the preset cannot be retargeted onto the model, the call returns an error. At most one of animation_url, preset_id and  ⟨101 unchanged words⟩ 

 ⟨83 unchanged words⟩ : humanoid_template (standard 22-joint skeleton with named joints, required for animating from the preset library) 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 ⟨79 unchanged words⟩ 

 ⟨117 unchanged words⟩ "rig_type":{"description":"Which skeleton to build. Pickbuild: humanoid_templategeneral (or humanoid_template_hands) if you intend to use animate3DModelPreset later - the default general rig cannot take presets. general, (any asset), humanoid (anime-style characters), game ⟨3 unchanged words⟩ or the pinned humanoid templates with named joints required for the animation preset library - humanoid_template (22 joints) / humanoid_template_hands (52, five fingers per hand). Templates only suit two-armed, two-legged characters. Animation presets (animate3DModelPreset) retarget onto any rig type, though not onto every model. Default: \"general\".","enum":[ ⟨17 unchanged words⟩ 

 ⟨5 unchanged words⟩  a named built-in preset voice, with optional emotionlanguage and languageeither settings.an emotion or a delivery note, depending on the voice. Both text and voice_preset_id are required and the text is limited to 1000250 characters;characters. invalidThe 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 ⟨124 unchanged words⟩ 

 ⟨7 unchanged words⟩  using a voice preset","properties":{"delivery":{"description":"How the line is said, e.g. \"angry, shouting\" or \"whispering, out of breath\" (max 50 characters). Only for the first-name voices (e.g. \"Rachel\"); a descriptive voice returns HTTP 400 - use emotion instead.","maxLength":50,"type":"string"},"emotion":{"description":"Emotion to apply to the speech. Only for the descriptive voices (e.g. \"Serious woman\"); a first-name voice returns HTTP 400 for any emotion other than Default - use delivery instead.","enum":["Default","Happy","Sad ⟨8 unchanged words⟩ string"},"language":{"description":"Language code forof the speech. Each voice family supports its own list of languages; \"auto\" detects it from the text.","enum":["auto","English","Afrikaans ⟨34 unchanged words⟩ ,"Thai","Turkish","Ukrainian","Vietnamese","Armenian","Assamese","Asturian","Azerbaijani","Belarusian","Bengali","Bosnian","Burmese","Cebuano","Dutch","Estonian","Galician","Georgian","Gujarati","Hausa","Icelandic","Irish","Javanese","Kannada","Kazakh","Kyrgyz","Latvian","Lingala","Lithuanian","Luxembourgish","Macedonian","Malayalam","Maltese","Maori","Marathi","Mongolian","Nepali","Occitan","Odia","Pashto","Punjabi","Serbian","Sindhi","Somali","Swahili","Tajik","Telugu","Urdu","Uzbek","Welsh","Yoruba"],"example":"auto","type":"string ⟨32 unchanged words⟩ ":"Text to convert to speech (max 1000250 characters).","maxLength":1000250,"type":"string"},"voice_preset_id":{"description":"Voice preset identifier. Two families of voices: the ones named by a first name (e.g. \"Rachel\", \"Roger\") take a delivery note and no emotion; the descriptive ones (e.g. \"Serious woman\", \"Deep voice man\") take an emotion and no delivery note.","enum":["Serious woman","Wise woman", ⟨23 unchanged words⟩  boy","Friendly man","Deep voice man","Rachel","Aria","Roger","Sarah","Laura","Charlie","George","Callum","River","Liam","Charlotte","Alice","Matilda","Will","Jessica","Eric","Chris","Brian","Daniel","Lily","Bill"],"example":"Serious woman","type" ⟨10 unchanged words⟩ 

 ⟨10 unchanged words⟩ "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. Bothtext is required, plus voice_description andor textimage are(an requiredimage of the speaking character, given as a URL or base64, makes the description optional); the spoken text is limited to 200100 characters or the call returns HTTP 400,  ⟨118 unchanged words⟩  server instructions).

Credits: This endpoint consumes 12 credits per call.

 ⟨5 unchanged words⟩  generating a voice sample from a character description and/or a character image","properties":{"augment_prompt":{"description": ⟨55 unchanged words⟩ "example":true,"type":"boolean"},"image":{"description":"URL or base64-encoded image of the speaking character (concept art, at most 15MB). The voice is designed from it, and voice_description becomes optional.","example":"<url> OR data:image/png;base64,...","type":"string"},"request_id":{"description":"Optional client-provided identifier,  ⟨27 unchanged words⟩ "Text for the voice to speak (max 200100 characters).","maxLength":200100,"minLength":1,"type":"string"}, ⟨28 unchanged words⟩ deep-voiced warrior\", \"cheerful young girl\"). Required unless image is given; with an image, a few words of hints.","type":"string"}},"required":["voice_description","text"],"type":"object"}}," ⟨4 unchanged words⟩ 

 ⟨72 unchanged words⟩  on hydra (default; also returns `audio_url`), hydra-plus (hydra with finer detail, also returns `audio_url`), forge, or forge-pixel for pixel-art sprites - the ⟨40 unchanged words⟩ optional GIF and frame URLs, `audio_url` on hydra and hydra-plus). Credits are held for the duration you ⟨116 unchanged words⟩  Hydra 3/s (shortest duration 3s, so 9 credits minimum), Hydra+ 4/s (shortest duration 3s, so 12 credits minimum), Forge 1.5/s, Forge Pixel  ⟨11 unchanged words⟩ 

 ⟨13 unchanged words⟩  frame beyond its borders ("outpaint"), or 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`, ⟨47 unchanged words⟩ "outpaint", and not accepted for "fix_loop" or "improve"; optionally add up to 5 reference `images`  ⟨22 unchanged words⟩ GIF or individual frames). 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 youwas requestedheld, and the difference (or everything, if  ⟨33 unchanged words⟩  are priced per model (credits/second × duration); and held for the duration you requested; "outpaint", "fix_loop" and "fix_loopimprove" run a lighter pipeline in which `model`  ⟨5 unchanged words⟩ at a flat 1 credit per second of output, held for and capped at the outputlength durationof (the source spritesheet's durationvideo unless(`duration` youdoes passnot onechange their price). Outpaint decides the extra margin itself - ⟨12 unchanged words⟩  animateSprite (`spritesheet_url`, `video_url`, grid fields); new audio is generated only by prompt edits on hydra: "fix_loop", so"outpaint" aand fix"improve" ondo anot hydraregenerate sheetit, comesand backtheir withoutresult `audio_url`.carries the source spritesheet's `audio_url` when it had one. Pass an optional `request_id` to tag the result  ⟨33 unchanged words⟩  flat 1 credit per second of output, capped at the source spritesheet's video length, no minimum, model ignored; edit_mode "improve" (hydra spritesheets only): flat 1 credit per second of output, same terms; edit_mode "prompt": per model as listed  ⟨23 unchanged words⟩ 

 ⟨13 unchanged words⟩ operation - prompt-driven edit (default), outpaint, loop fixing, or loopimprove fixing.(finer detail, on hydra spritesheets only).","properties":{"crop":{"description": ⟨70 unchanged words⟩ ":{"description":"Edit operation to perform. \"improve\" re-renders the animation with finer detail (the extra pass hydra-plus runs when it generates) and only takes a spritesheet generated with hydra; any other source returns HTTP 400, including an already improved spritesheet (or a loop fix or outpaint of one), which has that detail already. Default: \"prompt\".","enum":["prompt","outpaint","fix_loop","improve"],"example":"prompt","type":"string ⟨309 unchanged words⟩  \"outpaint\", not accepted for \"fix_loop\" or \"improve\". Focus it on a single change and ⟨156 unchanged words⟩ 

 ⟨168 unchanged words⟩ anything else about the motion. Runs on hydra only.(default) or hydra-plus (finer detail). The job result is the same sprite result ⟨152 unchanged words⟩ 

 ⟨51 unchanged words⟩  hydra: 3, 3.5, 4, 4.5, 5\n- hydra-plus: 3, 3.5, 4, 4.5, 5","format":"float","maximum":5 ⟨282 unchanged words⟩  minimum · Most capable all-around model, generates audioaudio\n- \"hydra-plus\" (Hydra+): 4 credits/s, shortest duration 3s, so 12 credits minimum · Hydra but with better fine details. Slower generations Default: \"hydra\".","enum":["hydra","hydra-plus"],"type":"string"},"prompt": ⟨139 unchanged words⟩ 

 ⟨33 unchanged words⟩  file, not an AI model name - thererigging ishas no model choice on the 3D tools). The job result is a downloadable `model_url` ⟨140 unchanged words⟩ 

 ⟨139 unchanged words⟩  server instructions).

Credits: This endpoint consumes 34 credits per call.

 ⟨49 unchanged words⟩ Yue","Croatian","Czech","Danish","English","Filipino","Finnish","French","German"," ⟨127 unchanged words⟩ 

 ⟨37 unchanged words⟩  id, name, category, description, duration, preview_url, and - when the preset can be retargeted onto a rigged 3D model - clip_urlpreview_url), a deduplicated perspectives array, and the  ⟨48 unchanged words⟩ animateSprite (text-prompt animation), or animate3DModelPreset (apply a clip_url-backedany preset by id to a rigged 3D model).

 ⟨108 unchanged words⟩  a different prompt, model or settings instead. Before reporting a limitation, call searchDocs with what you tried: if the docs already describe it as a known limitation, do not report it. Describe what you were trying to do and  ⟨46 unchanged words⟩ 

 ⟨89 unchanged words⟩ , not a bug: do not report it. A limitation the docs already describe (check with searchDocs) is known: do not report it.","enum":["limitation","bug"," ⟨67 unchanged words⟩ 

 ⟨144 unchanged words⟩ the job is accepted; the final charge is max(rate × seconds of video generated, the model's minimum charge), never more than for the duration you requested, ⟨88 unchanged words⟩  × seconds, per model: Hydra 3/s (minshortest chargeduration 3s, so 9 credits minimum), Forge 1.5/s (min charge 4 credits), Forge Pixel 1.5/s (min charge 4 credits);1.5/s; see this endpoint's full pricing table in the API docs.

 ⟨1121 unchanged words⟩  \"hydra\" (Hydra): 3 credits/s, minshortest chargeduration 3s, so 9 credits minimum · Most capable all-around model, generates audio\n- \"forge\" (Forge): 1.5 credits/s, min charge 4 credits · Sharper detail, simpler motion. Best for simple ⟨10 unchanged words⟩  \"forge-pixel\" (Forge Pixel): 1.5 credits/s, min charge 4 credits · Best for low-res pixel art animations\nforge-pixel expects ⟨326 unchanged words⟩ 

 ⟨111 unchanged words⟩ the job is accepted; the final charge is max(rate × produced seconds, the model's minimum charge), never more than for the duration you  ⟨143 unchanged words⟩ 

 ⟨110 unchanged words⟩ the job is accepted; the final charge is max(rate × produced seconds, the model's minimum charge), never more than for the duration you  ⟨123 unchanged words⟩ 

 ⟨129 unchanged words⟩ the job is accepted; the final charge is max(rate × seconds of video generated, the model's minimum charge), never more than for the duration you requested, ⟨186 unchanged words⟩  credits/s × seconds, per model: Hydra 3/s (min charge 9 credits), Forge 2/s (min charge 4 credits), Forge Pixel 2/s (min charge 4 credits);2/s; see this endpoint's full pricing table in the API docs.

 ⟨351 unchanged words⟩ :\n- \"hydra\" (Hydra): 3 credits/s, min charge 9 credits · Most capable all-around model, generates audio\n- \"forge\" (Forge): 2 credits/s, min charge 4 credits · Sharper detail, simpler motion. Best for simple ⟨10 unchanged words⟩  \"forge-pixel\" (Forge Pixel): 2 credits/s, min charge 4 credits · Best for low-res pixel art animations Default ⟨191 unchanged words⟩ 

 ⟨97 unchanged words⟩ the job is accepted; the final charge is max(rate × produced seconds, the model's minimum charge), never more than for the duration you requested, ⟨67 unchanged words⟩  × seconds, per model: Griffin HD 2/s (shortest duration 5s, so 10 credits minimum), Eagle 2/s [LEGACY]; [LEGACY] models ⟨22 unchanged words⟩ 

 ⟨95 unchanged words⟩  \"griffin-hd\" (Griffin HD): 2 credits/s, shortest duration 5s, so 10 credits minimum · Same as Griffin, but in 720p\n-  ⟨124 unchanged words⟩ 

 ⟨229 unchanged words⟩  that length when the job is accepted, andor neverfor less3 thanseconds thewhen model'sit minimumis chargeshorter (a new view is a new generation, and hydra generates at least 3 seconds, so 9 credits); the final charge is the model's rate ⟨71 unchanged words⟩ 

 ⟨332 unchanged words⟩  \"hydra\" (Hydra): 3 credits/s, minshortest chargeduration 3s, so 9 credits minimum · Most capable all-around model, generates audio  ⟨148 unchanged words⟩ 

 ⟨176 unchanged words⟩ the job is accepted; the final charge is max(rate × seconds of video generated (which follows the reference clip or preset),preset; thelegacy model'smodels keep their minimum charge), never more than for the  ⟨136 unchanged words⟩  credits/s × seconds, per model: Hydra 3/s (min charge 9 credits), Forge 2/s (min charge 4 credits), Forge Pixel 2/s (min charge 4 credits), Tango 4/s (min charge 4 credits)  ⟨26 unchanged words⟩ 

 ⟨708 unchanged words⟩ :\n- \"hydra\" (Hydra): 3 credits/s, min charge 9 credits · Most capable all-around model, generates audio\n- \"forge\" (Forge): 2 credits/s, min charge 4 credits · Sharper detail, simpler motion. Best for simple ⟨10 unchanged words⟩  \"forge-pixel\" (Forge Pixel): 2 credits/s, min charge 4 credits · Best for low-res pixel art animations\n- \ ⟨368 unchanged words⟩ 

 ⟨669 unchanged words⟩ "example":true,"type":"boolean"},"margin_ratio":{"deprecated":true,"description":"Deprecated: prefer margin_ratio_horizontal / margin_ratio_vertical. Amount of padding around the sprite as a ratio (0.0 to 1.0). Sets both axes to this value. A per-axis value, when also given, overrides this for that axis. Supplying any margin value selects margin_ratio_mode \"manual\" unless margin_ratio_mode is set explicitly.","format":"float","type":"number"},"margin_ratio_horizontal":{"description":"Horizontal padding around the sprite  ⟨53 unchanged words⟩  margin_ratio_mode \"manual\" unless margin_ratio_mode is set explicitly; overrides the legacy margin_ratio on this axis.explicitly.","format":"float","type":"number ⟨311 unchanged words⟩  margin_ratio_mode \"manual\" unless margin_ratio_mode is set explicitly; overrides the legacy margin_ratio on this axis.explicitly.","format":"float","type":"number ⟨440 unchanged words⟩ 

 ⟨437 unchanged words⟩ "example":true,"type":"boolean"},"margin_ratio":{"deprecated":true,"description":"Deprecated: prefer margin_ratio_horizontal / margin_ratio_vertical. Amount of padding around the sprite as a ratio (0.0 to 1.0). Sets both axes to this value. A per-axis value, when also given, overrides this for that axis. Defaults to 0.15 when no margin value is given at all.","format":"float","type":"number"},"margin_ratio_horizontal":{"description":"Horizontal padding around the sprite  ⟨41 unchanged words⟩ punches) or if the sprite gets cut off. Overrides the legacy margin_ratio on this axis.","format":"float","type":"number ⟨188 unchanged words⟩ jumps) or if the sprite gets cut off. Overrides the legacy margin_ratio on this axis.","format":"float","type":"number ⟨437 unchanged words⟩ 

 ⟨226 unchanged words⟩ },"frame_size":{"description":"Size of eachthe framesprite in pixels, (widthnot andof height).the Itframe: sizesit sets how big the character is drawn in the exported sheet, and each frame also holds the space around the sprite, so frames onlycome -out itlarger doesthan notthis changevalue. It changes the export only, not how the sprite is generated. 0 is maximum ⟨1363 unchanged words⟩ 

 ⟨216 unchanged words⟩ },"frame_size":{"description":"Size of eachthe framesprite in pixels, (widthnot andof height).the Itframe: sizesit sets how big the character is drawn in the exported sheet, and each frame also holds the space around the sprite, so frames onlycome -out itlarger doesthan notthis changevalue. It changes the export only, not how the sprite is generated. 0 is maximum ⟨1306 unchanged words⟩ 

 ⟨112 unchanged words⟩ },"frame_size":{"description":"Size of eachthe framesprite in pixels, (widthnot of the frame - it sets how big the character is drawn, and height).each frame also holds the space around it, so frames come out larger than this value. 0 is for maximum resolution. Omit to keep the source spritesheet's frame size.setting. Accepted values: 32, 64, 96, 128 ⟨436 unchanged words⟩ 

 ⟨87 unchanged words⟩ },"frame_size":{"description":"Size of eachthe framesprite in pixels, (widthnot of the frame - it sets how big the character is drawn, and height).each frame also holds the space around it, so frames come out larger than this value. 0 is for maximum resolution. Omit to keep the source spritesheet's frame size.setting. Accepted values: 32, 64, 96, 128 ⟨353 unchanged words⟩ 

 ⟨139 unchanged words⟩ },"frame_size":{"description":"Size of eachthe framesprite in pixels, (widthnot of the frame: it sets how big the character is drawn in the exported sheet, and height).each frame also holds the space around the sprite, so frames come out larger than this value. 0 is maximum resolution. Exporting larger than the ⟨1017 unchanged words⟩ 

 ⟨15 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨101 unchanged words⟩ 

 ⟨22 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨162 unchanged words⟩ 

 ⟨104 unchanged words⟩ :"string"},"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨154 unchanged words⟩ 

 ⟨11 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨114 unchanged words⟩ 

 ⟨13 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨102 unchanged words⟩ 

 ⟨15 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨350 unchanged words⟩ 

 ⟨13 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨95 unchanged words⟩ 

 ⟨13 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨225 unchanged words⟩ 

 ⟨160 unchanged words⟩ Omit to keep the source spritesheet's frame count. Allow about one second of duration per 16 frames - above that the model may not be able to produce them all. Accepted values: 4, 9, 16, 25, ⟨45 unchanged words⟩ a URL or base64, to guide the edit. Two, at most three, work best: more references reduce the model's ability to use any of them correctly.","items":{"type":"string"}, ⟨139 unchanged words⟩ "outpaint\", not accepted for \"fix_loop\". Focus it on a single change and keep it short (under about 50 words); run a second edit for more.","type":"string"},"request_id":{ ⟨50 unchanged words⟩  as spritesheet_url). External URLs are not accepted. Edit the original animation rather than a previous edit's result: every edit re-renders the whole animation, so colors and detail drift further with each pass. If an edit did not work, retry from the original instead of editing on top.","example":"<url>","type":"string ⟨37 unchanged words⟩ 

 ⟨13 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨181 unchanged words⟩ 

 ⟨17 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨145 unchanged words⟩ 

 ⟨13 unchanged words⟩ ,"properties":{"augment_prompt":{"description":"AugmentRewrites theyour prompt behind the scenes.scenes Disableinto tothe haveform the model works best with. Leave it on (the default). Turning it off does not give you more control.control - it usually gives worse results. Do not disable it unless you really know what you are doing and have tested your prompts extensively. Default: true.","example":true,"type" ⟨158 unchanged words⟩ 

 ⟨146 unchanged words⟩  pixels (width and height). 0 is for maximum resolution. Exporting larger than the input image adds no detail: do not pick a size above the input's own resolution, and 0 gains nothing on inputs under 512 px. True Size is not available here: the image is not the first frame of the result, so there is nothing to align to. Accepted values: 32, 64, 96, 128, ⟨11 unchanged words⟩ :"number"},"frames":{"description":"NumberMaximum number of frames in the output spritesheet. Allow about one second of duration per 16 frames - above that the model may not be able to produce them all (64 frames needs a duration of at least 4). The result can have fewer frames when the duration is short or bad frames were removed. Accepted values: 4, 9, 16, 25, ⟨184 unchanged words⟩  as a ratio (0.0 to 1.0). UsefulEvery bit of margin is resolution taken from the sprite, so keep it as tight as the motion allows - about 0.15 - and go higher only for animationsmotion that extendextends sideways (e.g., sword slashes, punches). or if the sprite gets cut off. Overrides the legacy margin_ratio on this axis."," ⟨3 unchanged words⟩ :"number"},"margin_ratio_mode":{"description":"Controls howHow marginsthe aresprite appliedis aroundframed thefor sprite.generation. Defaults to \"manual\" (0.15 on each axis when no margin value is given); transfer motion has no \"auto\". SendingThe model always generates on a canvas of the same size, so any margin is canvas the sprite does not fill: the more margin, the lower the resolution and detail of the sprite. Keep the margins tight - about 0.15 - and raise only the axis the motion needs. \"none\" explicitlyanimates the image exactly as framed, so it must already have suitable margins (not touching the edges, not mostly empty space); an off-center sprite can give unpredictable results. Sending \"none\" together with a margin value fails with HTTP  ⟨25 unchanged words⟩  as a ratio (0.0 to 1.0). UsefulEvery bit of margin is resolution taken from the sprite, so keep it as tight as the motion allows - about 0.15 - and go higher only for animationsmotion that extendextends up or down (e.g., jumps). or if the sprite gets cut off. Overrides the legacy margin_ratio on this axis."," ⟨102 unchanged words⟩ be removed; pick a current model for anything new.new.\nforge is tuned for the motion presets (preset_id) and often fails to follow your own video - use hydra for custom footage. forge-pixel expects real pixel art - a perfect pixel grid at its natural resolution. Default: \"hydra\".","enum":[" ⟨244 unchanged words⟩  when both are sent the video is used. A video more than twice as long as `duration` gets heavily compressed and the motion turns rushed - trim it to the part you want, or raise `duration`.","type":"string"}},"required": ⟨7 unchanged words⟩ 

 ⟨259 unchanged words⟩  × seconds, per model: Hydra 3/s (shortest duration 3s,min socharge 9 credits minimum), Forge 1.5/s (min charge 4 credits) ⟨18 unchanged words⟩ 

 ⟨694 unchanged words⟩  \"hydra\" (Hydra): 3 credits/s, shortest duration 3s,min socharge 9 credits minimum · Most capable all-around model, generates audio\n-  ⟨325 unchanged words⟩ 

 ⟨46 unchanged words⟩ :image/png;base64,...","type":"string"},"image_type":{"description":"What kind of image the source is (e.g. \"sprite\"). Not needed when `image` is the URL of an image you generated on Ludo in the last 30 days, which keeps its own type. Set it when you pass base64 or an external URL, so a sprite is edited as a sprite and keeps its transparent background.","enum":["generic","screenshot","art","asset","sprite","sprite-vfx","sprite-tiling-horizontal","sprite-tiling-vertical","icon","logo","ui_asset","fixed_background","side_scrolling_background","vertical_scrolling_background","parallax_layer","texture","tile","item-icon","portrait","card-art","splash","3d"],"example":"sprite","type":"string"},"n":{"description":"Number of edited variations ⟨111 unchanged words⟩ 

 ⟨343 unchanged words⟩  × seconds, per model: Hydra 3/s (shortest duration 3s,min socharge 9 credits minimum), Forge 2/s (min charge 4 credits) ⟨18 unchanged words⟩ 

 ⟨287 unchanged words⟩  \"hydra\" (Hydra): 3 credits/s, shortest duration 3s,min socharge 9 credits minimum · Most capable all-around model, generates audio\n-  ⟨175 unchanged words⟩ 

SendReport feedbacka problem with the Ludo API itself to the Ludo team:team. aUse limitationit youONLY couldfor notAPI workbugs around(an error, a bugfailed or stuck job, a resultcrash, a response that diddoes not match thethis documentation,) and API limitations (a capabilityparameter, operation or format you needed that Ludothe API does not offer yetsupport, and that you could not work around). NEVER use it to report model limitations or praisethe forquality somethingof a result: an image, sprite, animation, 3D model, video or sound that workedlooks well.wrong, ignores part of the prompt, has artifacts or is not what you wanted is not an API bug. Do not report those; retry with a different prompt, model or settings instead. Describe what you were trying to do and what waswent missingwrong, and name the operation (and job_id,  ⟨37 unchanged words⟩ 

 ⟨17 unchanged words⟩ :"string"},"category":{"description":"limitationbug - somethingthe youAPI needederrored, thata didjob notfailed workor got stuck, or isa response did not supported;match bugthe documentation; limitation - somethingthe broke

 ⟨344 unchanged words⟩  × seconds, per model: Hydra 3/s (shortest duration 3s,min socharge 9 credits minimum), Forge 2/s (min charge 4 credits) ⟨39 unchanged words⟩ 

 ⟨491 unchanged words⟩  \"hydra\" (Hydra): 3 credits/s, shortest duration 3s,min socharge 9 credits minimum · Most capable all-around model, generates audio\n-  ⟨350 unchanged words⟩ 

 ⟨131 unchanged words⟩ , `audio_url` on hydra). Credits are held for the duration you requested when the job is accepted andaccepted; the final charge is max(rate × seconds of video generated, the model's minimum charge), never more than for the duration you requested, (rateand ×the duration,difference (or everything, if the model'sjob minimumfails chargeor ifis highercancelled), evenis thoughrefunded. theThe returned sheet is then trimmed to its best loop and usuallycan runsrun slightly shorter; everything is refundedshorter ifthan the jobvideo; failsthat ortrim is cancelled.not deducted. Use animateSprite instead for the classic single-image + ⟨80 unchanged words⟩ 

 ⟨22 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The description field is required and duration is ⟨101 unchanged words⟩ 

 ⟨86 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The optional modification_strength (0 to 1, default ⟨92 unchanged words⟩ 

 ⟨23 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The description field is required; duration must be ⟨111 unchanged words⟩ 

 ⟨21 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). The description field is required, duration is  ⟨112 unchanged words⟩ 

 ⟨53 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). Credits are held when the job is accepted ⟨92 unchanged words⟩ 

 ⟨36 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). Credits are held when the job is accepted ⟨95 unchanged words⟩ 

 ⟨72 unchanged words⟩ the sound you want. The job result is only the URL of the generated audio file, only;an MP3 or WAV (the URL's extension, .mp3 or .wav, says which); no video is returned. The audio is also ⟨77 unchanged words⟩ 

 ⟨61 unchanged words⟩ job result is a single audio result containing athe URL.URL of an MP3 or WAV file (the URL's extension, .mp3 or .wav, says which). Credits are held when the job is accepted ⟨88 unchanged words⟩ 

 ⟨115 unchanged words⟩ GIF or individual frames). Credits are held for the duration you requested when the job is accepted andaccepted; the final charge is max(rate × seconds of video generated, the model's minimum charge), never more than for the duration you requested, (rateand ×the duration,difference (or everything, if the model'sjob minimumfails chargeor ifis highercancelled), evenis thoughrefunded. theThe returned sheet is then trimmed to its best loop and usuallycan runsrun slightly shorter; everything is refundedshorter ifthan the jobvideo; failsthat ortrim is cancelled.not deducted. Prompt edits are priced per model (credits/second  ⟨180 unchanged words⟩ 

 ⟨162 unchanged words⟩ the model/duration combination is invalid. Credits are held whenfor the jobduration isyou acceptedrequested andwhen the chargejob is foraccepted; the durationfinal youcharge requestedis max(rate × duration,seconds of video generated (which follows the reference clip or preset), the model's minimum charge), ifnever higher)more than for the duration you requested, evenand thoughthe difference (or everything, if the job fails or is cancelled) is refunded. The returned sheet is then trimmed to its best loop and usuallycan runsrun slightly shorter; everything is refundedshorter ifthan the jobvideo; failsthat ortrim is cancelled.not deducted. Use this when you have an existing motion ⟨147 unchanged words⟩ 

 ⟨134 unchanged words⟩ . Credits are held when the job is accepted;accepted theand finalthe charge is maxfor the duration you requested (rate × produced secondsduration, or the model's minimum charge if higher), nevereven morethough thanthe forreturned thesheet durationis youtrimmed requested,to its best loop and theusually differenceruns (orslightly shorter; everything, is refunded if the job fails or is cancelled) is refunded.cancelled. Use animateSprite instead for the classic single-image + ⟨80 unchanged words⟩ 

 ⟨716 unchanged words⟩  1.5 credits/s, min charge 4 credits · UseSharper onlydetail, simpler motion. Best for basicsimple animationsbody shapes and simpleshort sprites.actions; Multiplemay triesneed mighta befew needed\n-tries\n- \"forge-pixel\" (Forge Pixel): 1.5 credits/s ⟨292 unchanged words⟩ 

 ⟨119 unchanged words⟩ . Credits are held when the job is accepted;accepted theand finalthe charge is maxfor the duration you requested (rate × produced secondsduration, or the model's minimum charge if higher), nevereven morethough thanthe forreturned thesheet durationis youtrimmed requested,to its best loop and theusually differenceruns (orslightly shorter; everything, is refunded if the job fails or is cancelled) is refunded.cancelled. Prompt edits are priced per model (credits/second  ⟨180 unchanged words⟩ 

 ⟨309 unchanged words⟩  2 credits/s, min charge 4 credits · Cost-effectiveSharper detail, simpler motion. Best for simple editingbody tasks\n-shapes and short actions; may need a few tries\n- \"forge-pixel\" (Forge Pixel): 2 credits/s ⟨142 unchanged words⟩ 

 ⟨166 unchanged words⟩ invalid. Credits are held when the job is accepted;accepted theand finalthe charge is maxfor the duration you requested (rate × produced secondsduration, or the model's minimum charge if higher), -even though the producedreturned lengthsheet followsis thetrimmed referenceto clipits -best loop and theusually differenceruns (orslightly shorter; everything, is refunded if the job fails or is cancelled) is refunded.cancelled. Use this when you have an existing motion ⟨147 unchanged words⟩ 

 ⟨513 unchanged words⟩  2 credits/s, min charge 4 credits · Cost-effectiveSharper fordetail, simplesimpler motion. WorksBest bestfor withsimple Presetsbody shapes and matchingshort poses\n-actions; may need a few tries\n- \"forge-pixel\" (Forge Pixel): 2 credits/s ⟨317 unchanged words⟩ 

 ⟨44 unchanged words⟩ generated with the hydra model already come with `audio_b64``audio_url`, so only call this for forge /  ⟨37 unchanged words⟩  to the spritesheet, so it appears as `audio_b64``audio_url` in listGenerations (type spritesheet), where the  ⟨62 unchanged words⟩ 

 ⟨244 unchanged words⟩ fix on a hydra sheet comes back without `audio_b64`.`audio_url`. Pass an optional `request_id` to tag the result ⟨89 unchanged words⟩ 

 ⟨76 unchanged words⟩  GIF / frame / with-background URLs, and `audio_b64``audio_url` when the model is hydra. `duration` defaults to ⟨274 unchanged words⟩ 

 ⟨105 unchanged words⟩ the items were generated from: api (your API/MCP/CLIAPI/MCP generations, last 7 days only), web  ⟨42 unchanged words⟩ 

 ⟨105 unchanged words⟩ the items were generated from: api (your API/MCPAPI/MCP/CLI generations, last 7 days only), web  ⟨42 unchanged words⟩ 

 ⟨767 unchanged words⟩ ":"Optional text description of the desired animation, (e.g., \"walking\", \"attack slash\"). When omitted, the motion is derived purely from the keyframes. When provided, describe exactly and unambiguously what the character should do. Specific or complex actions are fine; there is no need to simplify them. Do not over-describe, though: too much detail can harm the animation, and an action the model already knows should be named, not decomposed into its steps (\"walking\", never \"move the left foot forward, then the right foot\"). Do not restate what the keyframes already show (the character, its appearance and equipment, the art style, the background, the lighting, the camera), and leave frame count and timing to the frames and duration fields. Negative phrasing (\"no background\", \"do not move the camera\", \"without a weapon\") works only on hydra. On forge and forge-pixel it backfires: naming something you do not want makes it more likely to appear, so \"without a weapon\" tends to produce a weapon. On those models never phrase anything negatively; state only what should happen, and control everything else through the keyframes and the other fields.","type":"string"},"request_id":{ ⟨71 unchanged words⟩ 

 ⟨333 unchanged words⟩  for low-res pixel art animations Default: \"forge\hydra\".","enum":["hydra","forge" ⟨124 unchanged words⟩ 

 ⟨295 unchanged words⟩ , so 9 credits minimum · Most capable all-around model, generates audio\n- \"forge\" (Forge): ⟨160 unchanged words⟩ 

 ⟨85 unchanged words⟩ the model is hydra. `duration` defaults to 1.5s - or, whenwhere the chosen model doesoffers notit, offerotherwise 1.5sto that model's shortest (hydra, the default, starts at 3s), to that model's shortest - and a longer reference clip or preset  ⟨113 unchanged words⟩ a text prompt. Omit `model` to run on forgehydra (the default - cost-effectivemost andcapable, tunedand forreturns presetsaudio); pick hydraforge for complexa spritescheaper orrun whenon yousimple wantmotion, audio;presets and matching poses; the `model` field lists rates. Pass an optional ⟨96 unchanged words⟩ 

 ⟨499 unchanged words⟩ , so 9 credits minimum · Most capable all-around model, generates audio\n- \"forge\" (Forge): ⟨69 unchanged words⟩  current model for anything new. Default: \"forge\hydra\".","enum":["hydra","forge","forge-pixel","tango"],"example":"forgehydra","type":"string"},"perspective":{ ⟨253 unchanged words⟩ 

 ⟨13 unchanged words⟩  the rigged GLB in `model` (URL or base64base64; the 3D asset file, not an AI model name) and a `preset_id` from the animation presets list (see the spritesheet animation-presetsfrom endpointlistAnimationPresets) - only presets that expose a `clip_url`  ⟨77 unchanged words⟩ spot, as game-engine locomotion expects (omit to follow crop_loop). Credits are charged only on success. Requires ankeep APIthe keypreset's (userown scopetravel). Returns 202 with a job id immediately; poll `getApiJob`Credits (passare `wait:held 30`)when untilthe statusjob is succeeded,accepted thenand readrefunded itsif `result`it field,fails whichor is exactly the response documented for this operation. Each accountcancelled. mayAsync havegeneration upjob: toreturns 50`{id, generationsstatus}` queued- orpoll running`getApiJob` at(job once;and beyondcredit thatcontract: submissionssee returnthe 429server (PENDING_JOBS_LIMITinstructions) - wait for jobs to finish..

Credits: This endpoint consumes 0.2 credits per call.

 ⟨42 unchanged words⟩  the spot (engine-driven locomotion). Omit to followkeep crop_loop.the preset's own travel.","type":"boolean"},"model":{"description":"The already-rigged 3D asset, as a URL or base64-encoded already-rigged GLB file (rignot an AI model name). Rig it with arigModel humanoid_templateusing rig_type first).humanoid_template or humanoid_template_hands first.","example":"<url> OR data:model/gltf-binary;base64,... ⟨42 unchanged words⟩ existing job instead of generating again. Also usable withas the resultsrequest_id endpoint.filter of listGenerations.","type":"string"}},"required": ⟨8 unchanged words⟩ 

 ⟨55 unchanged words⟩  The job result is a single sprite result: `spritesheet_url` (spritesheetthe URLsheet image), frame`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, optionallywhen requested, `gif_url`, `individual_frame_urls` and `spritesheet_with_background_url`. The hydra model also returns `audio_b64`, a GIFsound oreffect individualfor framethe URLsanimation when- requested).there is no need to call createSpriteAudio afterwards; forge and forge-pixel produce no audio. The chosen model must support sprite animation and  ⟨7 unchanged words⟩ incompatible model/duration combinations return HTTP 400. Credits are chargedheld onlywhen onthe success,job basedis onaccepted; the final charge is max(rate × produced durationseconds, andthe model's minimum charge), never more than for the duration you requested.requested, Forand bestthe resultsdifference (or everything, callif generatePosethe firstjob tofails putor theis charactercancelled) intois therefunded. desiredChoosing pose,a thentool: animateanimateSprite it(this here;one) usewhen listAnimationPresetsyou tocan discoverdescribe namedthe presets,motion andin prefertext; transferMotion when you alreadywant havean exact motion copied from a reference video or presetone toof copythe motionnamed frompresets ratherfrom thanlistAnimationPresets describing(e.g. ita instandard text.walk Passor anattack optionalcycle); request_idgeneratePose tofirst tagwhen the resultsource soimage youis cannot locateyet itin laterthe viapose `GETthe /assets/sprites/results`.animation Requiresshould anstart APIfrom. keyOmit (user`model` scope).to Returnsrun 202on withhydra a(the jobdefault) id- immediately;see pollthe `getApiJob``model` (passfield `wait:for 30`)the untilper-model statusrates isand succeeded,the then4-credit readminimum itscharge `result`on field,forge/forge-pixel. whichPass isan exactlyoptional therequest_id responseto documentedtag forthe thisresult operation.so Eachyou accountcan maylocate haveit uplater tovia 50listGenerations generations(type queuedspritesheet). orAsync runninggeneration atjob: once;returns beyond`{id, thatstatus}` submissions- returnpoll 429`getApiJob` (PENDING_JOBS_LIMIT)job -and waitcredit forcontract: jobssee tothe finish.server instructions).

Credits: costcredits/s varies× byseconds, per model: andHydra 3/s (shortest duration 3s, so 9 credits minimum), Forge 1.5/s (credits/secmin charge 4 credits):, HydraForge 3/sPixel 1.5/s (min charge 4 credits), Blitz 1.9/s (min charge 4 credits) [LEGACY], Eagle 2.6/s (min charge 4 credits) [LEGACY], Eagle with Audio 3.1/s (min charge 4 credits), Forge[LEGACY]; 1.5/s[LEGACY] (minmodels 4),are Forgescheduled Pixelfor 1.5/sremoval (min- 4);do not use them for new work; see this endpoint's full pricing table in the API docs.

 ⟨111 unchanged words⟩  inconsistent frame sizes across different animations. Default: false.true.","example":falsetrue,"type":"boolean"},"duration":{" ⟨12 unchanged words⟩ : 3, 3.5, 4, 4.5, 5\n- blitzforge: 1.21, 1.5, 2, 2.5, 3, 3.5, 4\n- eagle: 1, 2, 3, 4\n- eagle-audio: 1, 24, 34.5, 4\n-5\n- forgeforge-pixel: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5\n- forge-pixelblitz: 11.2, 1.5, 2, 2.5, 3, 3.5, 44\n- eagle: 1, 4.52, 53,

 ⟨65 unchanged words⟩ is derived purely from the keyframes. Runs on thehydra Forge(default; familyalso returns `audio_b64`), theforge, onlyor forge-pixel for pixel-art sprites - the models supportingthat support a middle keyframes:keyframe; Forgeany (default)other ormodel Forgereturns PixelHTTP for400. pixel-artFor sprites;just botha sharestart theand sameend durationsframe, andanimateSprite pricing.with `final_image` does the same job. The job result is athe singlesame sprite result (spritesheetas URL,animateSprite frame(`spritesheet_url`, layout`video_url`, andgrid optionallyfields, aoptional GIF or individualand frame URLs, when`audio_b64` requestedon hydra). Credits are chargedheld onlywhen onthe success,job basedis onaccepted; the final charge is max(rate × produced durationseconds, andthe model's minimum charge), never more than for the duration you requested.requested, and the difference (or everything, if the job fails or is cancelled) is refunded. Use animateSprite instead for the classic single-image + text-prompt animation with model choice.animation. Pass an optional request_id to tag the result so you can locate it later via `GET /assets/sprites/results`. Requires an API keylistGenerations (usertype scopespritesheet). Returns 202 withAsync ageneration job id immediately; poll `getApiJob` (pass `wait: 30`)returns until`{id, status is succeeded,}` then- readpoll its`getApiJob` `result`(job field,and whichcredit iscontract: exactlysee the response documented for this operation. Each account may have up to 50 generations queued orserver runninginstructions).

Credits: atcredits/s once;× beyondseconds, thatper submissionsmodel: returnHydra 4293/s (PENDING_JOBS_LIMIT) - wait for jobs to finish.

Credits: costshortest variesduration by3s, modelso and9 durationcredits (credits/secminimum):, Forge 1.5/s (min charge 4 credits), Forge Pixel 1.5/s (min charge 4 credits); see this endpoint's full pricing table in the API docs.

 ⟨17 unchanged words⟩ initial / middle / final). Runs on thehydra Forge(default), familyforge or forge-pixel - the only models supporting a middle keyframe. Input images can  ⟨82 unchanged words⟩  inconsistent frame sizes across different animations. Default: false.true.","example":falsetrue,"type":"boolean"},"duration":{" ⟨12 unchanged words⟩ : 3, 3.5, 4, 4.5, 5\n- blitz: 1.2, 1.5, 2, 2.5, 3, 3.5, 4\n- eagle: 1, 2, 3, 4\n- eagle-audio: 1, 2, 3, 4\n- forge: 1, 1.5, 2, 2.5, 3 ⟨536 unchanged words⟩  \"hydra\" (Hydra): 3 credits/s, min 4\n-shortest \"blitz\"duration (Blitz):3s, 1.9so credits/s,

Cancel a queued job you started through the API or MCPMCP; andthe refundcredits itsheld credits.for it are refunded. Jobs that are already running cannot be canceled (409). Returns the canceled job. This is free (no credits). Requires an API key (user scope).

 ⟨57 unchanged words⟩ none", default "pbr"). Credits are chargedheld onlywhen onthe success.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 `GET /assets/3d-models/results`. Requires an API keylistGenerations (usertype scope3d). Returns 202 withAsync ageneration job id immediately; poll `getApiJob` (pass `wait: 30`)returns until`{id, status is succeeded,}` then- readpoll its`getApiJob` `result`(job field,and whichcredit iscontract: exactlysee the response documented for this operation. Each account may have up to 50 generations queued or running at once; beyond that submissions return 429server (PENDING_JOBS_LIMITinstructions) - wait for jobs to finish..

Credits: This endpoint consumes 3 credits per call.