Process local images with direct QuokkaPix settings
process_with_settingsProcess local image files with direct QuokkaPix agent settings for custom resize, crop, convert, compress, and scenario workflows.
Instructions
Process local image files with a direct window.QuokkaPixAgent.applySettings payload instead of an official recipe. Use this for custom resize/crop/convert/compress/background/watermark/effects/rename/PDF/favicon/scenario workflows. For multi-step scenarios, prefer settings.steps as [{ tool, settings }]. The adapter downloads the output, writes quokkapix-result.json and returns QA results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appUrl | No | Optional QuokkaPix app URL. Defaults to https://quokkapix.com/#agent=1. For safety, only quokkapix.com, localhost and 127.0.0.1 are accepted unless QUOKKAPIX_ALLOW_CUSTOM_APP_URL=1 is set. | |
| headless | No | Run Chromium headless. Defaults to true unless debugging. | |
| maxFiles | No | Maximum allowed input files for this direct settings run. Defaults to the selected files count. | |
| settings | Yes | Payload accepted by window.QuokkaPixAgent.applySettings. Extra editor-specific keys are allowed. | |
| outputDir | Yes | Local directory where the adapter writes the downloaded output and quokkapix-result.json. | |
| timeoutMs | No | Maximum processing timeout in milliseconds. | |
| inputFiles | Yes | Local source image files to upload through the browser file input. | |
| settingsId | No | Optional id/name for this generated settings workflow, used in returned metadata and QA profile. | |
| unlockToken | No | Optional x402 unlock token for paid agent batch/scenario runs above 5 files. | |
| expectedResultQa | No | Optional QA contract used to validate quokkapix-result.json after processing. | |
| watermarkLogoFile | No | Optional local logo/image file for logo watermark settings. | |
| backgroundImageFile | No | Optional local image file for background replacement settings. |