---
title: "Estimate"
method: POST
path: "/estimate"
tags: ["Estimate"]
---

# Estimate

`POST /estimate`

Validates the request against our standard models and returns the estimated time taken to complete a given processing job and the credits that would be consumed for that job.

## Request body

- EstimateGANRequest
  - `category` 'Enhance' | 'Sharpen' | 'Denoise' | 'Restore' | 'Lighting' | 'Matting' | 'Tool' — Indicates which category of model is being used.
  - `model` 'Standard V2' | 'Low Resolution V2' | 'CGI' | 'High Fidelity V2' | 'Text Refine' | 'Standard' | 'Strong' | 'Lens Blur' | 'Lens Blur V2' | 'Motion Blur' | 'Natural' | 'Refocus' | 'Wildlife' | 'Portrait' | 'Normal' | 'Extreme' | 'Adjust' | 'Adjust V2' | 'White Balance' | 'Colorize' | 'Object' | 'Transparency Upscale' — The model to use for processing the image.
  - `input_height` integer, required — The height of the input image in pixels.
  - `input_width` integer, required — The width of the input image in pixels.
  - `output_height` integer — The desired height of the output image in pixels. Your image will automatically be upscaled to this specified value. If only one of `output_height` and `output_width` is set, then the other dimension is scaled proportionally. Only applicable for Enhance models.
  - `output_width` integer — The desired width of the output image in pixels. Your image will automatically be upscaled to this specified value. If only one of `output_height` and `output_width` is set, then the other dimension is scaled proportionally. Only applicable for Enhance models.
  - `crop_to_fill` boolean — Default behavior is to letterbox the image if a differing aspect ratio is chosen. Enable `crop_to_fill` by setting this to `true` if you instead want to crop the image to fill the dimensions.
  - `output_format` 'jpeg' | 'jpg' | 'png' | 'tiff' | 'tif' — The desired format of the output image.

## Response `200`

The estimated time taken in seconds and the credits that would be consumed on process.

- EstimationResponse
  - `duration` integer, required — The estimated time taken in seconds for the image to be enhanced with the given parameters.
  - `credits` integer, required — The number of credits that would be consumed if the given requests was executed.

## Other responses

- `400` — The request contains malformed data in the body, path, or query parameters.
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too many requests hit the API too quickly. A backoff (e.g. exponential) is recommended for your requests.
- `500` — Internal server error

---

[API](https://skmtc.net/topazlabs/apis/image-api.md) · [All operations](https://skmtc.net/topazlabs/apis/image-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topazlabs/image-api/revisions/7610937217a4/schema)