try_hairstyle
Generate a hairstyle preview by rendering a person image with a chosen template or reference style; optionally keep their original hair color.
Instructions
Render a person with a different hairstyle (YouCam AI Hairstyle Generator v2.1). Costs 2 units on success. Give exactly one of template_id (from list_hairstyle_templates) or reference_image.
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": {
"person_image": "<person_image>"
},
"name": "try_hairstyle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| template_id | No | ||
| person_image | Yes | An https:// image URL on this server's allowlist, or an image_ref (img_...) returned by an earlier call in this session. JPEG or PNG. | |
| wait_seconds | No | Seconds to wait for the result before returning a task_ref to poll. Default 60. | |
| reference_image | No | An https:// image URL on this server's allowlist, or an image_ref (img_...) returned by an earlier call in this session. JPEG or PNG. | |
| keep_my_hair_color | No | Keep the person's own colour. Default false. |