---
title: "Estimate cost+duration before running full image analysis"
method: POST
path: "/v1/analyze/image/preflight"
tags: ["analyze"]
---

# Estimate cost+duration before running full image analysis

`POST /v1/analyze/image/preflight`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/analyze/image/preflight`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Run a single cheap vision pass to estimate the cost+duration of the
full from-image flow. Free to the user; we eat ~$0.02/call internally.

The frontend uses this output to render a "Will cost $X-Y, balance $Z.
Proceed?" confirmation before committing to the expensive perception
path. Auto-mode can skip the confirmation; customize-mode shows
per-asset choices once we have asset-level data (P2).

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Missing or invalid image
- `500`: Vision-model preflight failed

---

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