add_shape_key
Create a shape key (blend shape) on a mesh to store alternative vertex positions blended by a 0-1 value for expressions, morphs, or corrective shapes; first call creates the Basis.
Instructions
Add a shape key (blend shape). The first call also creates the Basis.
Shape keys store alternative vertex positions blended by a 0-1 value: facial expressions, morphs, corrective shapes. Shape it with move_shape_key_vertices, blend with set_shape_key, animate with keyframe_shape_key. A new key starts at value 1.0 (fully on), so edits show straight away; set it to 0 to hide it.
Args: object_name: Mesh object. key_name: Name for the new shape key. from_mix: Start from the current blend of all keys instead of the Basis.
Returns: Dict with the new key and every key on the object.
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": {
"object_name": "<object_name>",
"key_name": "<key_name>"
},
"name": "add_shape_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from_mix | No | ||
| key_name | Yes | ||
| object_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||