set_character_portrait
Attach a bust portrait to a saved character to serve as the starting frame for talking animations, overwriting any existing portrait.
Instructions
Attach a bust portrait to a saved character (free — no generation runs). The portrait is the starting frame for talking animations: vocal_animation generates mouth positions from it. Overwrites any existing portrait. To generate a portrait from a full-body sprite first, use portrait_character_pro with direction='character_to_portrait'.
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": {
"character_id": "<character_id>",
"image": "<image>"
},
"name": "set_character_portrait"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | Yes | Bust portrait image to attach | |
| character_id | Yes | Character ID |