Skip to main content
A smart entity is a named visual reference you can reuse in generations. Give it reference images and an @handle, then select it in a supported prompt instead of attaching and describing the same references each time.

Choose a type

All five types use 1–20 image references. Choose images that make the intended reference clear. Use several angles for a prop, recognizable views of an environment, or examples of the same visual style. A style entity uses reference images too. It is not a model fine-tune or a text-only preset. A scene is a visual reference for staging. Creating one does not assemble a 3D scene or a video timeline.

What an entity contains

  • References: the images that define it, plus a selected cover.
  • Name and handle: how you find it in the library and mention it in prompts.
  • Description: text that explains its visual characteristics. Characters require one. The other types allow it to be omitted.
  • Associated media: generations that used the entity and assets linked to it by hand.
The defining reference images are displayed separately from the associated-media gallery. Adding a media item to that gallery does not automatically make it a reference for future generations.

Reuse

Entity references help guide a model toward a consistent subject or look. The result depends on the model and its supported inputs. Using an entity is not a guarantee of an identical appearance in every output.

Creating and managing entities

Add references, choose handles, and maintain associated media

Using entities in generations

Mention references in Agent and supported model prompts