Add subject
add_subjectOptional. Adds someone or something to the cast beyond the narrator and the product — a side character (kind person), a pet, or an object — so moments can feature them by tagging @[Name]. Skip it unless the ad needs them. The image is either yours (image_url, or upload_id from create_media_upload; a photo meeting the requirements, ≥480×480 px) or generated (generate: true, a few credits, ready in about a minute: a person is drawn from archetype, the actor form's fields; a pet or object from description). Add subjects before the moments that tag them, and both before generate_script.
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": {
"project_id": "<project_id>",
"name": "<name>",
"kind": "<kind>",
"description": "<description>"
},
"name": "add_subject"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| name | Yes | Short and unique; scenes tag it as @[name]. | |
| generate | No | ||
| archetype | No | generate + kind person only: their look. | |
| image_url | No | ||
| upload_id | No | ||
| project_id | Yes | The project's id. | |
| description | Yes | Who or what it is, in a sentence or two. Used in prompts. |