Invent a new character from a text description and generate its portrait — the
full "make me a character, no photo involved" path in ONE call, instead of gluing
together create_character + update_character + generate_character_image yourself.
name: short and unique among YOUR OWN characters (see list_characters()) — how
you'll refer to this character afterwards, e.g. character="detective_marlowe" in
generate_with_face.
description: physical description — build, hair, eyes, clothing, distinguishing
features. Saved on the character's card AND used to generate the portrait, so
write it as concretely as you would any image prompt.
account: farm account (and its project) to create the character under.
The portrait is written to Flow's card exactly ONCE — that slot cannot be
regenerated. Calling this again with the SAME name does not retry it: it fails
fast with a clear message instead of hitting a raw HTTP 500 downstream. Want a
different look? Use a new name.
Returns {"name", "entity_id", "portrait_media_id", "portrait_url", "hint"} once
done. Next step for ANY further image of this character: generate_with_face(
character=name, prompt="...") — never entity_id/character_slot_index, which only
works for that one portrait write and cannot place the character into new scenes.