Image sepia

POST /api/image-sepia

Apply a sepia (warm brown) tone to an image. Configurable threshold to adjust how pronounced the sepia tinting is.

Applies a sepia tone — converts the image to a warm-brown monochrome reminiscent of vintage prints. The `threshold` option (0–99.99%, default 80) controls how pronounced the sepia tinting is. Lower = subtler.

Inputs

Name	Type	Default	Description
image*	file	—	Input image (PNG / JPEG / WebP).
threshold	number (0…100)	80	Tone-warmth percentage 0–100. Higher = brighter / more yellow. Default 80 matches IM's classic sepia recipe.
format	enum (png \| jpeg \| webp)	—	Output format. Defaults to the input's format.

Response

Modes: binary, base64-json. Cache: yes (24h TTL).

Code samples

Built from the default example.

# Download or substitute the example input:
#   curl -O https://xtract.bot/examples/image-png-to-webp/sample.png
IMAGE=$(base64 -w0 < sample.png)

curl -X POST https://api.xtract.bot/api/image-sepia \
  -H "Content-Type: application/json" \
  -H "Accept: application/octet-stream" \
  -H "X-Account-Id: $XTRACT_ACCOUNT_ID" \
  -H "X-Api-Key: $XTRACT_API_KEY" \
  -d '{
  "threshold": 80,
  "image": "'"$IMAGE"'"
}'