PixelDojo

Use PixelDojo's async API to generate and download AI images or videos.

Setup

Runtime requirements:

• Environment variable: PIXELDOJO_API_KEY
• Binaries: curl, jq, python3
• Optional override: PIXELDOJO_API_BASE

Set the API key before running any helper:

export PIXELDOJO_API_KEY=your_api_key_here

Optional local env file:

cp ~/.openclaw/skills/pixeldojo/.env.example ~/.openclaw/skills/pixeldojo/.env

Default API base: https://pixeldojo.ai/api/v1

Workflow

1. Check the live model catalog first.
2. Pick a model that matches the requested workflow.
3. Submit the job with generate.sh or the Nano Banana helper.
4. Poll status until complete, then return the downloaded asset path.

Do not guess model IDs.

Check the live catalog

bash ~/.openclaw/skills/pixeldojo/models.sh

For a pinned snapshot of known-good model IDs and example picks, read:

• references/model-catalog.md

Generate an image

bash ~/.openclaw/skills/pixeldojo/generate.sh image "editorial product photo of a silver robot" flux-2-pro --aspect-ratio 16:9

Good defaults:

• Best general image quality: flux-2-max
• Prompt adherence and typography: nano-banana-2
• Editing-oriented image work: flux-kontext-pro

Generate a video

bash ~/.openclaw/skills/pixeldojo/generate.sh video "cinematic ocean waves at sunset" seedance-1.5 --duration 5

Use --image-url for image-to-video models:

bash ~/.openclaw/skills/pixeldojo/generate.sh video "slow camera push-in" wan-2.6-flash --image-url https://example.com/input.png --duration 5

Nano Banana helper

Use this when the user specifically wants Nano Banana 2 or strong prompt adherence:

python3 ~/.openclaw/skills/pixeldojo/scripts/generate-nano-banana.py "clean ecommerce hero shot of running shoes" --aspect-ratio 16:9 --output ~/Desktop/shoes.png

Check job status

bash ~/.openclaw/skills/pixeldojo/status.sh job_abc123

Output paths

Default download folders:

• ~/Pictures/AI Generated/images/
• ~/Pictures/AI Generated/videos/

Override with:

--output /path/to/file.png

Notes

• generate.sh supports --aspect-ratio, --duration, --image-url, --output, --poll-interval, and --max-wait.
• generate.sh covers the shared prompt-based API flow. If a request needs model-specific editing payloads, inspect the live catalog and API behavior before improvising.
• PixelDojo markets full commercial rights for generated output, but the user is still responsible for complying with the service terms and any third-party model restrictions.