Save a creator
save_creatorStore a portrait and name as a reusable creator so the same person can appear in future ads; pass the saved image URL to avatar, video, or motion generation.
Instructions
Add a portrait to this workspace’s reusable CAST so the SAME person can star in future ads — the headless twin of the app’s + > Pick a creator > save. Pass the portrait’s public url (a generate_image render of an AI person, or a photo of a real person you have permission to use, or of yourself; never a photo just because it is public) plus a name to call them by; from then on list_creators returns them and their url can be re-passed to generate_avatar / generate_video / recast_motion. Saving is FREE and renders nothing (the one paid option is makeSheet, which makes their 16:9 character sheet). LIKENESS: leave source "generated" for an AI-made person (free on every plan) and use "upload"/"social" for a REAL person. Using a real person’s face, likeness or voice confirms you are them or have their consent, take full, unlimited responsibility for its use and will cover any claim against Hermoso (hermoso.ai/terms). Paid plan only; recorded.
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": {
"name": "<name>"
},
"name": "save_creator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| look | No | their canonical wardrobe/appearance in words — reused to hold the look steady across ads | |
| name | Yes | what to call this creator (e.g. “Sarah”) — list_creators and the app’s picker match on it | |
| brand | No | profile id/name from list_brands, this call only | |
| image | No | REQUIRED except with useAnyway. public https url of the portrait (an existing render’s url, or any public photo). Not a local file path — upload it with upload_file first and save the url that returns | |
| poses | No | up to 4 extra full-body / angle plates of the SAME person (public urls) — they make a wider shot hold the identity | |
| sheet | No | a CHARACTER SHEET of this creator to keep (public url): one 16:9 image, full body on the left, a close portrait on the right. Free. Works on a creator already saved (pass just name + sheet) | |
| voice | No | a default voice name for this persona (engines + voices are in hermoso_capabilities) | |
| source | No | "generated" (default) = an AI-made person; "upload" / "social" = a REAL person | |
| makeSheet | No | PAID (one image, see hermoso_capabilities job character_sheet): make that 16:9 character sheet FROM their saved portrait and keep it, so wide shots hold their full figure and outfit. Works on a creator already saved (pass just name + makeSheet). Describe their outfit head to toe in `look` first if it is not saved | |
| useAnyway | No | only for a creator whose saved photo was flagged too unclear to cast (render_ad says so): true casts the current photo as it is, no new image needed |