apyhub
▣ FILE CONVERSION · FILE MANIPULATION

Resize Images API

What it does

Image Resizer lets you resize an image by sending either a public image URL or an uploaded file, along with the target width and height. You can choose a direct binary download response or a signed URL response, depending on how you want to handle the resized image in your workflow.

Use the URL endpoints when the source image already lives online, or the multipart endpoints when you need to upload the file from your app. The request body for URL mode only needs url; multipart mode requires image. In every case, width and height are required query parameters. Optional query parameters include output, preserve_format, and auto_orientation.

The response matches the endpoint you call: download variants return the resized image as binary data, while link variants return a JSON object containing a data URI. That makes this service useful for thumbnail generation, profile-image processing, product image preparation, or any backend flow that needs a fixed-size image without adding image libraries to your stack.

▣ ENDPOINT 01 / 04
POST
Resize image (fetch by URL, download file)
https://api.eu.apyverse.com/apyhub/resize-image/url/download

QUICKSTART

GUIDE

Quickstart

Resize an image from a source URL by sending the image URL in the JSON body and the target dimensions as query parameters.

curl -X POST "https://api.eu.apyverse.com/apyhub/resize-image/url/download?width=800&height=600" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.jpg"}'

What you'll get back

Returns the resized image as a binary response body.

(binary file)
TRY ITLIVE · 30 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Resize URL mode — provide `url`.

About this endpoint

What it does

Resizes an image fetched from a URL and returns the resized file as a binary download. The request provides the source image URL in the body and the target dimensions in query parameters.

Query Parameter(s)

AttributeTypeMandatoryDescription
widthIntegerYesTarget image width in pixels. Minimum: 1.
heightIntegerYesTarget image height in pixels. Minimum: 1.
outputStringNoOutput filename prefix.
preserve_formatBooleanNoPreserve the original image format.
auto_orientationBooleanNoAutomatically apply the image's orientation metadata.

Request Body

ParameterTypeMandatoryDescription
urlStringYesSource image URL. Format: URI.

Response

Returns a binary file containing the resized image. The response schema is a binary string, so the success payload is the downloaded image itself rather than a JSON object.

Query parameters

Name
Type
Description
widthREQUIRED
integer
—
heightREQUIRED
integer
—
outputOPTIONAL
string
—
preserve_formatOPTIONAL
boolean
—
auto_orientationOPTIONAL
boolean
—

Body

Name
Type
Description
bodyREQUIRED
object
Resize URL mode — provide `url`.
▣ ENDPOINT 02 / 04
POST
Resize image (fetch by URL, signed URL)
https://api.eu.apyverse.com/apyhub/resize-image/url/link

QUICKSTART

GUIDE

Quickstart

Resize an image from a URL by sending the source link in the JSON body and the target dimensions as query parameters.

curl -X POST "https://api.eu.apyverse.com/apyhub/resize-image/url/link?width=800&height=600" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.jpg"}'

What you'll get back

Returns a JSON object with a data string field containing the resized image URI.

{
  "data": "https://..."
}
TRY ITLIVE · 30 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Resize URL mode — provide `url`.

About this endpoint

What it does

Resizes an image fetched from a URL and returns the resized image as a URI in the data field. The request requires the source image URL in the body and width and height as query parameters.

Query Parameter(s)

AttributeTypeMandatoryDescription
widthIntegerYesTarget image width. Minimum: 1.
heightIntegerYesTarget image height. Minimum: 1.
outputStringNoOutput name.
preserve_formatBooleanNoWhether to preserve the source image format.
auto_orientationBooleanNoWhether to apply automatic orientation handling.

Request Body

ParameterTypeMandatoryDescription
urlStringYesThe image URL to fetch and resize. Format: URI.

Response

Returns a JSON object with a data string field containing a URI for the resized image.

ParameterTypeMandatoryDescription
dataStringYesURI of the resized image.

Query parameters

Name
Type
Description
widthREQUIRED
integer
—
heightREQUIRED
integer
—
outputOPTIONAL
string
—
preserve_formatOPTIONAL
boolean
—
auto_orientationOPTIONAL
boolean
—

Body

Name
Type
Description
bodyREQUIRED
object
Resize URL mode — provide `url`.
▣ ENDPOINT 03 / 04
POST
Resize image (multipart upload, download file)
https://api.eu.apyverse.com/apyhub/resize-image/multi-part/download

QUICKSTART

GUIDE

Quickstart

Upload an image file and set the target dimensions to get back the resized file.

curl -X POST "https://api.eu.apyverse.com/apyhub/resize-image/multi-part/download?width=800&height=600" \
  -H "apy-token: $APY_TOKEN" \
  -F "image=@/path/to/image.jpg"

What you'll get back

Returns a binary file (string with format: "binary"), which is the resized image content.

<binary image data>
TRY ITLIVE · 30 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*

About this endpoint

What it does

Resizes an uploaded image using multipart form data and returns the resized image as a binary file download. The request provides the source image in the body and the target dimensions as query parameters.

Query Parameter(s)

AttributeTypeMandatoryDescription
widthIntegerYesTarget width in pixels. Minimum: 1.
heightIntegerYesTarget height in pixels. Minimum: 1.
outputStringNoOutput file name prefix or name. Example: my-invite.
preserve_formatBooleanNoWhen true, preserves the input image format.
auto_orientationBooleanNoWhen true, applies automatic orientation handling.

Request Body

ParameterTypeMandatoryDescription
imageStringYesImage file to resize. Binary file upload.

Response

Returns a binary file download — the response schema is a single string with binary format, not a JSON object. The success response body itself is the resized image file.

Query parameters

Name
Type
Description
widthREQUIRED
integer
—
heightREQUIRED
integer
—
outputOPTIONAL
string
—
preserve_formatOPTIONAL
boolean
—
auto_orientationOPTIONAL
boolean
—

Body

Name
Type
Description
bodyREQUIRED
object
—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 04 / 04
POST
Resize image (multipart upload, signed URL)
https://api.eu.apyverse.com/apyhub/resize-image/multi-part/link

QUICKSTART

GUIDE

Quickstart

Resize an image from a public URL by sending the image file plus the required width and height as multipart form fields.

curl -X POST "https://api.eu.apyverse.com/apyhub/resize-image/multi-part/link?width=800&height=600" \
  -H "apy-token: $APY_TOKEN" \
  -F "image=@/path/to/image.jpg"

What you'll get back

Returns a JSON object with a data string field containing a URI for the resized image.

{
  "data": "https://example.com/resized-image.jpg"
}
TRY ITLIVE · 30 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*

About this endpoint

What it does

Resizes an uploaded image and returns a signed URL to the generated output. You send the image as multipart form data, along with required dimensions and optional processing flags.

Query Parameter(s)

AttributeTypeMandatoryDescription
widthIntegerYesTarget width. Minimum: 1.
heightIntegerYesTarget height. Minimum: 1.
outputStringNoOutput name. Example: my-invite.
preserve_formatBooleanNoWhether to preserve the original image format.
auto_orientationBooleanNoWhether to automatically apply image orientation before resizing.

Request Body

ParameterTypeMandatoryDescription
imageStringYesImage file to upload. Binary format.

Response

Returns a JSON object with a data string field formatted as a URI — the signed URL for the resized image.

ParameterTypeMandatoryDescription
dataStringYesSigned URL returned by the service. Format: URI.

Query parameters

Name
Type
Description
widthREQUIRED
integer
—
heightREQUIRED
integer
—
outputOPTIONAL
string
—
preserve_formatOPTIONAL
boolean
—
auto_orientationOPTIONAL
boolean
—

Body

Name
Type
Description
bodyREQUIRED
object
—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Product
CatalogPricingQuickstartBecome a providerStatus (opens in new tab)
Company
AboutBlogCareers (opens in new tab)Contact
Legal
Terms of ServicePrivacy PolicyProvider terms
© 2026 APYHUB · BUILT FOR DEVELOPERS