Actors

148 built-in AI actors for consistent character generation. Use --actor name on any generation command, or create your own custom actors from any photo.

Built-in Actors

Browse the full library of ready-to-use actors. Click any actor to see details, tags, and usage examples. Use the search and filters to narrow down by gender, age group, or type.

148 actors found

Custom Actors

Create your own AI actors from any face photo. Custom actors work the same as built-in ones and stay consistent across all your generations. This is useful for branding, recurring characters, or using real people as references.

Creating a Custom Actor

Use melies ref create to generate a custom actor from any image URL. The image should be a clear face photo. Melies will process it and create a reusable reference you can use across all commands.

Parameters

`<label>`	Name for this reference (e.g. "John", "My Character")
`-i, --imageUrl`	Public image URL of the face photo (default: required)
`-t, --type`	Reference type: actor or object (default: actor)

Best results

Use a high-quality, well-lit face photo with a neutral expression. Front-facing portraits work best. Avoid group photos or heavily cropped images.

bash

Listing Your References

View all your saved custom actors and object references. Each reference shows its ID, label, type, and processing status.

bash

Using Custom Actors

Once your reference is ready, use it with the --ref flag on any generation command. Pass the reference ID returned by melies ref list.

Custom actors use the --ref flag (not --actor). The --actor flag is for built-in actors only.

bash

Deleting References

Remove a custom actor or object reference you no longer need.

bash

Object References

References aren't limited to actors. You can also save objects, props, clothes, or any visual element for reuse across generations. Use -t object when creating the reference.

bash