Getting Started

flyimg is an on-the-fly image processing microservice. Give it a source image URL and control the output — resize, crop, compress, and convert between formats (JPEG, WebP, AVIF, PNG) — entirely through URL parameters. No SDKs required. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

Step 1: Create a flyimg instance

Navigate to the flyimg service in Eyevinn OSC, click Create flyimg, and enter a name. The instance starts within a few seconds.

Click the instance card when the status indicator is green to copy the base URL — it will look like https://{name}.flyimg-flyimg.auto.prod.osaas.io.

Step 2: Process an image

Append the processing options and the source image URL to the base path:

https://{instance-url}/upload/{options}/{source-image-url}

Resize to 400 × 300 px and convert to WebP:

https://{instance-url}/upload/w_400,h_300,o_webp/https://example.com/photo.jpg

Resize with cropping enabled (fill mode):

https://{instance-url}/upload/w_200,h_200,c_1/https://example.com/photo.jpg

Common options:

Parameter Description Example
w_ Output width in pixels w_800
h_ Output height in pixels h_600
c_1 Enable cropping / fill mode c_1
o_ Output format (webp, avif, png, jpg) o_webp
q_ Quality 1–100 q_80
r_1 Progressive rendering r_1

Usage Example

Use flyimg as an image CDN proxy in your application:

function imgUrl(src, width, height) {
  const base = 'https://myimages.flyimg-flyimg.auto.prod.osaas.io';
  return `${base}/upload/w_${width},h_${height},c_1,o_webp/${encodeURIComponent(src)}`;
}

// <img src={imgUrl('https://cdn.example.com/hero.png', 1200, 630)} />

CLI Usage

osc create flyimg-flyimg myimages

Resources