apyhub
FILE CONVERSION · FILE MANIPULATION

Convert WebP to AVIF API

Hosted on ApyHub

What it does

WebP to AVIF Converter turns a WebP image into an AVIF file. Send either a public image URL or a multipart file upload, and get back the converted image as a download or a signed URL.

Use the URL-based endpoints when the source image is already hosted publicly. Send body.url, and choose the output query parameter if you want a named output. The service returns either binary file data or a JSON response with a data URI, depending on the endpoint you call.

Use the multipart endpoints when you already have the file in your request. Send body.file, and again choose between direct download and signed-link responses. That makes it easy to plug into upload flows, media pipelines, or server-side image jobs where you want AVIF output without handling conversion locally.

Typical uses include optimizing product images, preparing web assets for modern browsers, or converting uploaded WebP files before storage or delivery. The API is limited to WebP input and AVIF output, so the request and response format stay predictable.

▣ ENDPOINT 01 / 04
POST
Convert WebP to AVIF (fetch by URL, download file)
http://localhost:8080/apyhub/mono-go-webp-to-avif-conversion/url/download
QUICKSTARTGUIDE

Quickstart

Convert a WebP image from a public URL to AVIF by sending the source URL in the JSON body.

curl -X POST "http://localhost:8080/apyhub/mono-go-webp-to-avif-conversion/url/download" \
  -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 response containing the converted AVIF output.

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*
Publicly accessible URL of the WebP image to convert.

About this endpoint

What it does

Converts a WebP image fetched from a publicly accessible URL into an AVIF file and returns the converted file as binary output.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOutput filename to use for the downloaded file.

Request Body

ParameterTypeMandatoryDescription
urlStringYesPublicly accessible URL of the WebP image to convert. Must be a URI.

Response

Returns a binary file containing the converted AVIF image.

Query parameters

Name
Type
Description
outputOPTIONAL
string

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 02 / 04
POST
Convert WebP to AVIF (fetch by URL, return signed URL)
http://localhost:8080/apyhub/mono-go-webp-to-avif-conversion/url/link
QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/apyhub/mono-go-webp-to-avif-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 resulting AVIF file URL.

{
  "data": "https://apyhub-outgoing.s3.eu-west-1.amazonaws.com/mono-go/image-processor/general/image_2026-08-07_cf9f3365.avif?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARJOHWS6LWTUUGYPI%2F20260807%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T121820Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=inline&response-content-type=image%2Favif&X-Amz-Signature=d1199c81abb9826d98ffecb1b1755209881fc5266219bb0ed09d6f343c8b0254"
}
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*
Publicly accessible URL of the WebP image to convert.

About this endpoint

What it does

Converts a WebP image fetched from a publicly accessible URL into AVIF, then returns the resulting signed URL in the response.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOptional output name/slug for the generated file.

Request Body

ParameterTypeMandatoryDescription
urlStringYesPublicly accessible URL of the WebP image to convert. Must be a URI.

Response

Returns a JSON object with a data string field containing a URI. This is the successful response body for the conversion result.

ParameterTypeMandatoryDescription
dataStringNoURI of the generated AVIF file.

Query parameters

Name
Type
Description
outputOPTIONAL
string

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 03 / 04
POST
Convert WebP to AVIF (multipart upload, download file)
http://localhost:8080/apyhub/mono-go-webp-to-avif-conversion/multi-part/download
QUICKSTARTGUIDE

Quickstart

Upload a WebP file to download its AVIF conversion. This example includes the required file upload and the optional output name query parameter.

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

What you'll get back

Returns a binary file which is the converted AVIF download.

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

Converts an uploaded WebP file to AVIF and returns the converted file as a binary response. The request takes the file in the multipart body and an optional output query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOptional output name.

Request Body

ParameterTypeMandatoryDescription
fileStringYesThe WebP file to convert.

Response

Returns a binary file download containing the converted AVIF output.

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 04 / 04
POST
Convert WebP to AVIF (multipart upload, return signed URL)
http://localhost:8080/apyhub/mono-go-webp-to-avif-conversion/multi-part/link
QUICKSTARTGUIDE

Quickstart

Upload a WebP file from your machine and get back an AVIF file URL.

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

What you'll get back

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

{
  "data": "https://apyhub-outgoing.s3.eu-west-1.amazonaws.com/mono-go/image-processor/general/image_2026-08-07_7fc14914.avif?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARJOHWS6LWTUUGYPI%2F20260807%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T122308Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=inline&response-content-type=image%2Favif&X-Amz-Signature=434ea2270546bc21021a1488a6cfd8337337c4abc26a396d2e07b8fefa71e675"
}
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

Converts an uploaded WebP file to AVIF and returns a signed URL in the response. The request sends the file as multipart form data and can optionally include an output query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOptional output name.

Request Body

ParameterTypeMandatoryDescription
fileStringYesThe WebP file to upload for conversion.

Response

Returns a JSON object with a data string field formatted as a URI. The data field contains the signed URL returned after the conversion request is accepted.

ParameterTypeMandatoryDescription
dataStringNoSigned URL returned by the endpoint.

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.

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