Upscale Agent Skill

Upscaling with Guaardvark

Read setup first; needs the upscaling plugin (POST /api/plugins/upscaling/start).

B=${GUAARDVARK_URL:-http://localhost:5000}. Models: GET $B/api/upscaling/models (default HAT-L_SRx4);

install one with POST $B/api/upscaling/models/download {"model": "<id>"} only after the user says so.

One image (synchronous, seconds)

curl -s -X POST $B/api/upscaling/upscale/image \
  -F file=@/abs/path/in.png -F model=HAT-L_SRx4 -F scale=4 -F sharpen=0.2 -F denoise_strength=0.1

Returns the finished file (output_path, served under GET $B/api/upscaling/output/image/<filename>).

Form options: model, scale, sharpen, denoise_strength.

Many images (queued)

curl -s -X POST $B/api/upscaling/upscale/images -F [email protected] -F [email protected] -F model=HAT-L_SRx4 -F scale=2

Returns a job id; poll GET $B/api/upscaling/jobs/<job_id>; GET $B/api/upscaling/jobs lists all.

Video (queued, frame by frame)

curl -s -X POST $B/api/upscaling/upscale/video -H 'Content-Type: application/json' -d '{
  "input_path": "/abs/path/clip.mp4", "model": "realesrgan-x2", "scale": 2, "two_pass": false, "suffix": "_4k"
}'

output_path is optional. Same job polling. Video upscaling is slow: minutes per hundred frames

at 1080p on a 16 GB card. Say so before queuing.

Rules

• Preview first when in doubt: POST $B/api/upscaling/preview (multipart, same form fields) runs a crop.
• Pick the model for the content: HAT-L for photos, Real-ESRGAN x2 for video, anime models for

line art. The models list carries descriptions.

• The GPU is exclusive; a running video upscale blocks image and video generation until it finishes.