Jobs

Enqueue one to four motions generated from a text prompt (ML /generate/motion). Each is saved to the account's motions (GET /games/motions) and can be used wherever an animation preset goes. One GENERATE_MOTION charge per motion (Roles: user)

Changed on
post/jobs/generate-motion

Request

Request body

request_idstring
promptstring required

The move, in any language (sword slash, zombie walk). With augment_prompt false it goes to the motion model as written and has to follow the format given there.

num_variantsinteger

How many motions to generate, each with its own seed and each charged.

seedinteger

Seed of the first variant.

durationnumber float

Length in seconds. Omit to let the ML choose. Required when augment_prompt is false.

loopboolean

A seamless cycle (walk, idle), 2 to 8 s. Omit to let the ML choose.

start_idleboolean

Start on the relaxed standing pose (not with a loop). Omit to let the ML choose.

end_idleboolean

End on the relaxed standing pose (not with a loop). Omit to let the ML choose.

left_hand'relaxed' | 'fist' | 'grip' | 'open' | 'flat' | 'point' | 'thumbs_up' | 'pinch' | 'v_sign' | 'claw'

The left hand's pose. Only these are supported (no free text). Omit to let the ML choose.

right_hand'relaxed' | 'fist' | 'grip' | 'open' | 'flat' | 'point' | 'thumbs_up' | 'pinch' | 'v_sign' | 'claw'

The right hand's pose, as left_hand.

keep_facingboolean

No turning, for fixed-direction sprites. Omit to let the ML choose (on unless turning is the point of the move).

augment_promptboolean

On by default: the prompt is rewritten for the motion model and every option left out is inferred from it. False sends the prompt to the motion model as written, so write it in the model's own format: one plain English sentence of under 50 words that starts with "A person". Describe only how the body moves, including which limbs and which side, e.g. "A person swings a sword overhead with the right arm and steps forward on the left foot". Leave out props, scenery, camera, clothing and story; a held object is only implied through the arms ("as if holding a sword in the right hand"). Do not describe hand shapes in the prompt: use left_hand and right_hand. For a loop, describe one steady repeating movement with no start or stop ("A person walks forward at a steady pace"). duration has to be set explicitly; it is not inferred from the text.

Response

Accepted

jobIdstring required
status'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' required
queue_positioninteger

Changes