// THE IMAGE API FOR DEVELOPERS

The image API that does everything.

Generate or upload an image, host it on a global CDN, and resize, reformat, or recolor it — all from a single API and a single URL.

Get your API key Read the docs

npm i visionfly·3 lines to a live URL

Upload a file…

Upload Generate

vf.upload(beach-sunset.jpg)

uploading…

CDN URL

https://img.visionfly.ai/elephant.png

// ONE API, THE WHOLE PIPELINE

Upload or generate

Push an existing file, or create one from a prompt.

Store

Every image is hosted and backed up on durable edge storage.

Deliver

Served from a global CDN, cached close to every user.

Transform

Resize, reformat, crop, and recolor right in the URL.

//One API

Your whole image stack, in one call.

Generate, host, optimize, and transform every image with a single SDK and a single bill. One thing to learn, one thing to scale.

01generate

Generation API

Fal · Replicate

02host

Storage / CDN

S3 · uploadthing

03transform

Image CDN

Cloudinary

one call

VisionFly

generate · host · transform

//Ingest

Bring your own, or make one.

Upload an existing file or generate one from a prompt — either way, you get back the same kind of live, optimized CDN URL in a single call.

import { VisionFly } from "visionfly";
 
const vf = new VisionFly("vf_live_...");
 
const image = await vf.upload("beach-sunset.jpg");
 
console.log(image.url);
// https://img.visionfly.ai/beach-sunset.webp

stored on edgeCDN URL ready

200 OKuploaded or generatededge: sfo

//Transform

Resize, crop, and recolor from the URL.

Change a query param for a new size, format, crop, or background. Generated once, then edge-cached forever — every variant is a single GET.

resize

https://img.visionfly.ai/elephant.webp?w=400

crop

https://img.visionfly.ai/elephant.webp?w=400&fit=crop

reformat

https://img.visionfly.ai/elephant.webp?format=avif

recolor bg

https://img.visionfly.ai/elephant.webp?bg=blue

every variant is one GET request — cached at the edge after the first hit

//Use anywhere

Upload once. Use it everywhere.

One stored image serves every size and shape your UI needs — each is just a different set of URL params. No duplicate assets, no re-uploading, no export step.

Source — uploaded once

img.visionfly.ai/elephant.webp↓ one image, every placement below

FIELD NOTESThe great migration

Blog hero?w=1600&ar=16:9

Article card?w=480&ar=16:9&fit=crop

Avatar?w=72&ar=1:1&radius=max

visionfly.ai

Social / OG?w=1200&ar=1.91:1

//Optimize

Automatic webp & avif, ~10× smaller.

VisionFly picks the best format per browser and serves it automatically. Lighter images, faster apps, lower bandwidth — with zero work from you.

hero.pngwebp

before

2.1 MB

after

180 KB

−91% bytes

avatar.jpgavif

before

540 KB

after

38 KB

−93% bytes

banner.pngwebp

before

4.8 MB

after

410 KB

−91% bytes

//Quickstart

Live in three lines.

Install the JavaScript SDK and generate your first optimized, transformable URL. Python SDK coming soon — or call the REST API from anything.

bash

#one install

$npm i visionfly

✓ installed visionfly 1.0.0

1import { VisionFly } from "visionfly";
2 
3const vf = new VisionFly("vf_live_...");
4const url = await vf.generate("an elephant on yellow");
5// -> img.visionfly.ai/elephant.webp?w=400

//Pricing

One credit. Everything.

Storage, bandwidth, transforms, and AI all draw from a single pool of credits. Exceed your plan and we auto-bill the overage at a flat rate — set a cap, and we never suspend you mid-spike. That’s the whole model.

Free

25 credits / mo