Actions26
- Account Actions
- Character Actions
- Folder Actions
- Image Actions
- Model Actions
- Tools Actions
Character → List Characters
AI-generatedSummary
List characters from Supermachine, optionally filtered by model and category.
Inputs
- modelId (required) — Select model to list characters for. Choose from the list, or specify an ID using an expression.
- categoryId — Filter by character category (optional). Choose from the list, or specify an ID using an expression.
- returnAll — Whether to return all results or only up to a given limit. Default: false.
- limit — Max number of results to return. Applied only when returnAll is false. Default: 20. Range: 1–100.
Output shape
array
JSON array of character objects retrieved from the Supermachine API. Each item includes name and embedCode. Paginated according to limit when returnAll is false.
Examples
Example 1: List up to 10 characters for a specific model
modelId = 'DreamShaper', limit = 10, returnAll = false
Example 2: List all characters for a model without limit
modelId = 'Anything V3', returnAll = true