Actions26
- Account Actions
- Character Actions
- Folder Actions
- Image Actions
- Model Actions
- Tools Actions
Image → List Images
AI-generatedSummary
Retrieve a list of generated images from Supermachine, optionally filtered by batch ID, folder, or model, with pagination controlled by returnAll and limit.
Inputs
- returnAll — Whether to return all results or only up to a given limit. When false, the limit parameter caps the number of results returned.
- limit — Maximum number of results to return. Valid values are between 1 and 100. Only applied when returnAll is false.
- filters — Optional filter collection. Supports filtering by batchId, folderId, or model. Each filter is optional and can be combined.
Output shape
The raw Supermachine API response JSON for the /v1/images endpoint. The response typically includes an items array with image metadata (ID, URL, batch ID, status, createdAt, etc.) and optional pagination metadata (total, page, perPage). When returnAll is false and a limit is set, the API respects the limit parameter.
The node passes query parameters (limit when returnAll is false, batchId, folderId, model) to the GET https://dev.supermachine.art/v1/images endpoint via the authenticated supermachineApi credential.
Examples
Example 1: List the 20 most recent images
Leave returnAll false (default) and set limit to 20 (default), or omit both for default behavior.
Example 2: List all images from a specific batch
Set returnAll to true, or omit limit. Provide the batch ID in the batchId filter field.
Example 3: List images filtered by model and folder
Set returnAll to false, limit as desired, folderId to the desired folder ID or expression, and model to the desired model name or ID.