Resize an image to fit inside a box, fill it and crop, fit and pad, or stretch to exact dimensions. Here is the whole call in Python, with the output it produced when we ran it.
Before you start
An API key. Create a free account; it comes with free tokens every month. Put the key in an environment variable so it stays out of your code: export BLOODWEB_KEY=your_key
Python 3 with the requests library: pip install requests
The input file in the same folder: photo.jpg. Use your own; that is the name the code expects.
The code
Save it as image-resize.py and run python3 image-resize.py.
import os
import requests
resp = requests.post(
"https://bloodweb.net/api/v1/image-resize",
headers={"Authorization": f"Bearer {os.environ['BLOODWEB_KEY']}"},
files={"file": open("photo.jpg", "rb")},
data={"width": "800", "height": "800", "fit": "cover"},
timeout=120,
)
if not resp.ok:
raise SystemExit(f"{resp.status_code}: {resp.json()['error']['message']}")
with open("thumb.jpg", "wb") as f:
f.write(resp.content)
What you get
Tested 19 October 2026: this exact code ran against our test copy of the API, which runs the same service code as bloodweb.net, and produced this.
It writes thumb.jpg: a JPEG image, 800 × 800 pixels, 15 KB.
Change the call
Every option the Image resizer takes. Add or change them the same way as the ones in the code.
width: Target width in pixels. Give width, height or both.
height: Target height in pixels.
fit: inside: fit within the box, keeping proportions. cover: fill the box and crop the overflow from the centre. pad: fit within the box and fill the rest with the background. exact: stretch to the box. cover, pad and exact need both width and height. One of: inside, cover, pad, exact.
gravity: Which part of the image to keep when fit=cover crops it. One of: center, top, bottom, left, right, top-left, top-right, bottom-left, bottom-right.
upscale: Allow enlarging an image smaller than the box (inside and pad).
to: Output format. Defaults to the input format (HEIC becomes JPG, ICO becomes PNG). One of: jpg, png, webp, avif, gif, tiff, bmp.
quality: For JPG, WebP and AVIF.
background: Padding colour for fit=pad, or "transparent" where the format allows it.
strip: Remove metadata.
If it fails
A failed call is not charged. The answer is JSON with an error object; the code above prints its message. The usual ones:
401missing_key or invalid_key: BLOODWEB_KEY is not set in the shell that runs the code, or the key was revoked.
415unsupported_type: the file is not a type this service reads. The type is read from the file itself, so renaming a file does not change it.
413file_too_large: the file is over the limit on the service page.
402insufficient_tokens: the balance does not cover the call. Top up in the dashboard.
429rate_limited: too many calls at once. Wait the seconds in the Retry-After header and send it again.
