▣ FILE CONVERSION

Convert WebP to PNG API

Hosted on ApyHub

What it does

WebP to PNG Converter turns a WebP image into a PNG, either from a multipart file upload or from a publicly accessible image URL. You can choose to download the converted file directly or receive a signed URL in the response.

Use the multipart endpoints when you already have the image in your request body: send file, and optionally set output as a query parameter. Use the URL endpoints when the source image is already hosted elsewhere: send url in the body, plus the optional output query parameter. The download endpoints return binary PNG data. The link endpoints return an object with a data field containing a URI.

This is a fit for image pipelines that need PNG output for browser compatibility, design tooling, or downstream processing that does not handle WebP reliably. It is also useful when you need to convert remote assets without downloading and re-uploading them yourself.

▣ ENDPOINT 01 / 04

POST

Convert WebP to PNG (multipart upload, download file)

http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/multi-part/download

QUICKSTARTGUIDE

Quickstart

Upload a WebP file and optionally name the download via output.

curl -X POST "http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/multi-part/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.webp" \
  -F "output=my-invite"

What you'll get back

Returns a binary file (string with format: binary) containing the converted PNG output. Since the response is binary, there is no JSON object to sample here.

TRY ITLIVE · 30 ATOMS

API key

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.

About this endpoint

What it does

Converts an uploaded WebP file to PNG and returns the converted file as binary content. The request sends the source file in the body, and the response is a downloaded file stream.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output filename prefix or name hint. Example: `my-invite`.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	The WebP file to convert. Multipart upload file input.

Response

Returns a binary file response: the converted PNG content is streamed back directly, not wrapped in a JSON object. The output schema is string with binary format, so there are no JSON fields to parse.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

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 02 / 04

POST

Convert WebP to PNG (multipart upload, return signed URL)

http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/multi-part/link

QUICKSTARTGUIDE

Quickstart

Upload a WEBP file to convert it to PNG, and optionally name the output via the output query parameter.

curl -X POST "http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/multi-part/link?output=my-invite" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.webp"

What you'll get back

Returns a JSON object with a data string field containing the resulting file URI.

{
  "data": "https://apyhub-outgoing.s3.eu-west-1.amazonaws.com/mono-go/image-processor/general/image_2026-08-07_a49e3037.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARJOHWS6LWTUUGYPI%2F20260807%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T123841Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=inline&response-content-type=image%2Fpng&X-Amz-Signature=0af6a52eb5b6988238714ec9b6642783958e664bc3d0bffa061d02719fc147b1"
}

TRY ITLIVE · 30 ATOMS

API key

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.

About this endpoint

What it does

Uploads a WebP file as multipart form data, converts it to PNG, and returns a signed URL to the converted output. You can optionally supply an output query parameter to influence the output identifier.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output name or identifier.

Request Body

Parameter	Type	Mandatory	Description
file	File	Yes	The WebP file to upload for conversion.

Response

Returns a JSON object with a data string field formatted as a URI — the signed URL for the converted PNG output.

Parameter	Type	Mandatory	Description
data	String	No	Signed URL to the converted PNG file.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

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 03 / 04

POST

Convert WebP to PNG (fetch by URL, download file)

http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/url/download

QUICKSTARTGUIDE

Quickstart

Convert a public WebP image URL to PNG by sending the image URL in the JSON body.

curl -X POST "http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/url/download?output=my-invite" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.webp"}'

What you'll get back

Returns a binary file containing the converted PNG image.

TRY ITLIVE · 30 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a WebP image fetched from a public URL into a PNG file and returns the resulting file as binary data. The request body supplies the source image URL, and the response is the converted PNG file.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Optional output file name prefix.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	Publicly accessible URL of the WebP image to convert. Must be a valid URI.

Response

Returns a binary response containing the converted PNG file. The output schema is a single binary value, so there is no JSON wrapper or top-level JSON field in the success response.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 04 / 04

POST

Convert WebP to PNG (fetch by URL, return signed URL)

http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/url/link

QUICKSTARTGUIDE

Quickstart

Convert a public WebP image URL to PNG by sending its URL in the JSON body.

curl -X POST "http://localhost:8080/apyhub/mono-go-webp-to-png-conversion/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.webp"}'

What you'll get back

Returns a JSON object with a data string field containing the PNG file URL.

{
  "data": "https://apyhub-outgoing.s3.eu-west-1.amazonaws.com/mono-go/image-processor/general/image_2026-08-07_9203c793.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARJOHWS6LWTUUGYPI%2F20260807%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T123933Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=inline&response-content-type=image%2Fpng&X-Amz-Signature=7795ee3653b3b30f79b8b2c3ba48568fb8a5c300076cbc4442a35163e243e125"
}

TRY ITLIVE · 30 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Fetches a WebP image from a public URL, converts it to PNG, and returns a JSON object containing a PNG file URL in data.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	String value sent as a query parameter. No additional constraints are defined in the schema.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	Publicly accessible URL of the WebP image to convert. Must be a URI.

Response

Returns a JSON object with a data string field — a URI for the converted PNG output.

Parameter	Type	Mandatory	Description
data	String	No	URI of the converted PNG file.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ 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.