Set actor
set_actorCasts the on-camera narrator and renders their portrait, which every scene is generated from — the app's actor form. Leave archetype out to cast someone fitting the audience automatically. Pass archetype to design them: for a project with an actor, only the fields you give change (e.g. just clothing); a first actor needs every field except facialFeatures. Also sets the narrator's spoken language and accent (language, language_accent) when given; to change only those, use set_narrator_voice, which doesn't recast. Each call renders a new portrait (7 credits, 10 on Premium). Show the user previewUrl: it is the actor Retiplex uses; never generate or substitute a picture of them yourself.
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": "set_actor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | Ask the user which language the ad is spoken in unless it is obvious (a Spanish market means "es"). Default en. One of: en (English), cs (Czech), nl (Dutch), de (German), it (Italian), pl (Polish), sk (Slovak), es (Spanish). Set it BEFORE the creative brief and script (create_project or set_narrator_voice): they are written in it. | |
| archetype | No | ||
| project_id | Yes | The project's id. | |
| language_accent | No | Optional regional accent, e.g. "Castilian Spanish" or "Mexican Spanish". Defaults to a native accent of the language; changing the language clears it. |