---
title: "Upscale an image file on disk"
method: POST
path: "/v1/images/upscale/file"
tags: ["Image"]
---

# Upscale an image file on disk

`POST /v1/images/upscale/file`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/images/upscale/file`
- Auth: HTTP bearer

File-path image upscale that reads and writes the filesystem directly (no base64 round-trip).

## Request body

- object
  - `input_path` string, required
  - `output_path` string: Auto-generated in a temp dir if omitted
  - `model` string
  - `format` 'png' | 'jpeg' | 'heic'
  - `quality` number

## Response `200`

Upscaled

- object
  - `output_path` string, required
  - `bytes` integer, required
  - `model` string, required
  - `format` string, required

## Other responses

- `400`: Invalid request
- `404`: Resource not found
- `413`: File too large

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)