Change what one cast member is (and redraw just them)
describe_cast_memberCHANGES ONE cast member into a different character: you pass a new one-line visual description, aicut rewrites the member's stored look from it and draws ONE new portrait (the rest of the roster is untouched). It is the tool for 'make the husband smaller and a white strawberry': NOT regenerate_cast_portrait (the SAME character again), nor a new generate_cast (it re-authors every member and re-buys every portrait). WHEN: the user wants a member to BE something else. character_id is the member's id from generate_cast_portraits or list_characters (kind cast_member); a free generate_cast draft has no library ids, so re-draft that instead. THE DESCRIPTION: ONE line of plain visual English, WHOLE, not a diff ('a small white strawberry man in a rumpled shirt', never 'the same but smaller'): the stored look is rebuilt from it alone, so fold in what the member already was; under about 500 characters. Do not read the line back: show the RESULT. IT PERSISTS: later episodes cast the NEW character. THE CARD: this call already put the aicut cast card up, each portrait filling in as it generates: do not poll or call show_generation (one get_image read of portrait_image_id if asked). No card (a terminal)? Poll each generating member's portrait_image_id with wait_for_generation (media image) and give the urls. AFTER: returns the member with its new description, portrait_image_id, portrait_status: "generating", changed (can be []) and a report: RELAY THE report as written. changed: [] means the member ALREADY had exactly this description and a portrait was bought anyway. IF THE PICTURE FAILS OR THE ACCOUNT RUNS OUT (402) THE DESCRIPTION HAS ALREADY CHANGED: the member is the new character wearing its old portrait; say so, and regenerate_cast_portrait draws the new look for one portrait's price. Do not re-send this tool (it buys a second picture). A 503 portrait_not_attached means the portrait WAS generated and CHARGED but did not attach: call THIS tool again with the quoted idempotency_key and the same arguments to re-attach it; a different key, or regenerate_cast_portrait, would buy a second one. COST: one standard image at image_model (or the platform default portrait model), the same as regenerate_cast_portrait; estimate_only: true prices it without re-describing anything. THE GO: one change, one named member, one priced ask. SPENDS TOKENS: price with estimate_only: true, ask in the SAME message as the price, and wait for a go that names THIS purchase (SPENDING RULES, this server's instructions). IDEMPOTENCY: a reused idempotency_key REPLAYS the first job whatever the settings: never reuse one for a new generation (this server's instructions).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | What this character looks like NOW: one whole line of plain visual English (see THE DESCRIPTION). Not a diff or an image prompt: anything omitted is lost. | |
| image_model | No | Image model: the member's OWN `image_model` from `generate_cast_portraits` (matches the cast and its price). Omitted, the platform default portrait model is used: maybe a different look and price. | |
| character_id | Yes | The cast member's library id: `id` on a `generate_cast_portraits` member or on a `list_characters` entry of kind `cast_member`. | |
| estimate_only | No | Price only; creates nothing. | |
| idempotency_key | No | Retry-safety key (IDEMPOTENCY). |