Check installed revision, deployed release, GPU, memory use and media/state paths.

code_matches compares deployed worker hashes with this checkout, or is null if unknown.

Return supported Fusion parameter names, defaults, choices and numeric limits.

Read video/audio codec, frame rate, dimensions and duration from a workstation file.

Queue face detection. Poll job_status, then inspect crops with view_artifact.

Single-frame detection (frame, zero based) returns faces with crop reference paths usable as FaceMapping.target_face. To find who appears across a video, pass sample_frames (N evenly spaced frames) or explicit frames (at most 64) instead: faces are grouped into identities by recognition-embedding similarity at Fusion's default similarity threshold. Each identity lists its appearances, frames, sample boxes and a representative crop (reference_path, verified to re-detect as one face) usable as target_face. Both modes write contact.jpg, one grid of every crop labelled "face N" or "id N: x" (* marks an unverified reference); view it first.

Queue an image/frame preview or CFR video render using explicit identity mappings.

Preview processes frame. Render processes start_frame and at most max_frames (None means through the end). Outputs are new job artifacts. Video output is H.264, with the selected interval's first audio stream encoded to AAC. Preview defaults to Inswapper128. Consult get_settings before changing parameters. GPU jobs run one at a time. Renders reject VFR, nonzero start times, odd dimensions and rotation; use normalize_media.

Queue conversion of a video into a render-ready copy. Runs on CPU without the GPU lock.

Output is CFR H.264 (CRF 18, yuv420p) starting at zero, with rotation applied, metadata removed and odd dimensions padded by one pixel. The first audio stream becomes AAC aligned to the first video frame. Without fps, the source average rate is used, snapped to a standard rate within 2%. The completed result's media_path is usable in submit_swap.

Read durable queued/running/completed/failed/cancelled state, progress and results.

With wait_seconds > 0 the call blocks on the workstation until the job's status or progress stage differs from its value at call time, the job is terminal, or the wait elapses, then returns the current state. Frame counts advancing within a stage do not end the wait. The worker log tail is returned when include_log is true or the job failed.

List the most recently updated jobs, including jobs submitted by another client.

Each summary has kind, status, media_path, frame (start_frame/max_frames for renders, fps for normalization), created/started/finished timestamps, elapsed_seconds since submission (until finish), error and progress. Use job_status for results and logs.

Request cancellation of a queued/running job. Poll until its state is terminal.

Permanently delete a completed, failed or cancelled job with its logs and artifacts.

Queued and running jobs are refused; cancel them and wait for a terminal state first.

Report or delete old terminal jobs, unused uploads and files left by crashed transfers.

Removes terminal jobs finished more than older_than_days ago and uploads untouched for that long that no queued/running job references. Dry run by default; returns the paths, jobs and byte totals that were (or would be) deleted.

Show a completed job's PNG/JPEG crop or preview inline in Claude or Codex.

Download a completed artifact into the configured local downloads directory.

Returns its absolute Mac path. Large videos stream directly to disk.

Stream a Mac image/video to private workstation storage and return its remote path.

Accepts PNG, JPEG, WebP, MP4, MKV and MOV up to 20 GiB. Use this path in other tools. Uploads are content-addressed: re-uploading identical media returns the existing path.