generate_motion
Transform text descriptions into animated 3D character motions with configurable export format, frame rate, and model. Get a batch ID for progress tracking.
Instructions
Generates motion animation based on text prompts. Returns a batch ID for tracking the generation progress. Consumes generation credits. Submit once, then use get_batch and list_batch_motions to poll; do not resubmit to check progress.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"exportSettings": "<exportSettings>",
"prompts": "<prompts>",
"requestedModel": "<requestedModel>"
},
"name": "generate_motion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loop | No | If true, the motion generation will be looped on a seamless repeat. Applied to all motions in a batch. Defaults to false. | |
| prompts | Yes | The prompts describing the desired motions | |
| batchName | No | An optional name to be associated with the batch. Will be used to identify the batch in the Cartwheel UI and email notifications. | |
| exportSettings | Yes | The export settings for the motion generation | |
| requestedModel | Yes | The model to use for the motion generation | |
| swingProperties | No | Optional parameters specific to the 'swing' model. Ignored if requestedModel is not 'swing'. |