CLI reference › PixelLab utilities

estimate-skeleton

pixelkiln estimate-skeleton <image> [--out keypoints.json] [--frames 4] [--force]

PixelLab only. Derives an 18-joint skeleton from an image via /estimate-skeleton. The image must be square at 16, 32, 64, 128, or 256 pixels, the sizes the endpoint takes; anything else is refused before the call. Same category as balance: a direct, un-budgeted account call outside the manifest/plan/lock pipeline — no manifest is read beyond locating .env.local, and nothing is written to a lockfile.

The output is a whole keypoints file, the shape an animate-skeleton revision's keypointsFile must be (see Controlled asset revisions): the estimated pose as firstFrameKeypoints, and --frames copies of it (3–15, default 4) as the frames to move into the motion. It prints, or writes to --out; --out refuses to replace an existing file, which is usually hand edits, unless --force is given.