Media platform & edge delivery
Convertly gives your product one place to convert, compress, deliver through the Image CDN, stream adaptive video, run Forma AI transforms, store files, and automate with jobs, workflows, and webhooks. Use the hosted app for manual batches and Transform Lab previews, or use the API and SDKs when your product needs programmatic control.
What is Convertly?
Convertly is media infrastructure for products that accept, transform, and deliver user files. It handles conversion, edge delivery through the Image CDN, adaptive video streaming, media tools, Forma AI, storage, async jobs, webhooks, and dashboard workflows without wiring together separate services for each step. It is built for SaaS products, internal tools, marketplaces, agencies, creator platforms, and AI-assisted workflows where files need to move from raw upload to production-ready output.How Convertly fits together
Convertly is organized around four layers. Most teams start with Deliver (Image CDN) or Process (convert/compress/Forma AI), then add storage, jobs, and webhooks as volume grows.| Layer | What it does | Dashboard | Start here |
|---|---|---|---|
| Deliver | Transform and cache images and video at the edge; adaptive HLS streams for playback. | Image CDN · Streams | Image CDN · Video streaming |
| Process | Convert, compress, thumbnail, trim, inspect, and AI-transform files on demand. | Convert · Compress · Forma AI | Media conversion · Forma AI |
| Ingest | Store originals and outputs, import from URLs or cloud drives, or point the CDN at a public HTTPS origin. | Assets · Sources | Files & storage |
| Automate | Queue batches, run workspace workflows, and react to signed webhook events. | Workflows · History | Async jobs · Webhooks |
Dashboard tour
| Section | Purpose |
|---|---|
| Home | Recent files and quick actions |
| Assets | Folders, uploads, sharing, imports |
| Convert / Compress | Manual batches with the same options as the API |
| Forma AI | Studio for generate, edit, upscale, and restyle |
| Workflows | Visual pipelines with test and live runs |
| Image CDN | Delivery namespaces, origins, presets, domains, purge, Transform Lab |
| Sources | HTTPS and bucket origins for CDN fetch |
| Streams | Adaptive video encoding and playback |
| Integrations | WordPress and other first-party connectors |
| History | Past jobs and workflow runs |
Why use Convertly?
One media API
Convert images, video, audio, documents, SVGs, and archives through one authenticated API.
Image CDN
Serve responsive images and video with on-the-fly transforms, poster frames, clips, smart cropping, and edge caching.
Forma AI
Generative edits, upscale, background removal, and studio workflows. available in the dashboard and API.
Video streaming
Upload source video and deliver adaptive HLS playback with the Convertly player SDK.
Async jobs & workflows
Queue large batches, build dashboard workflows, and keep long-running work outside your request cycle.
Storage and webhooks
Save originals and outputs, send signed events, and continue downstream workflows when work completes.
Quick start
Create an API key
Open the dashboard account menu → Settings → API keys. Store the token as
CONVERTLY_API_KEY on your server.Follow the quickstart
Platform overview, API conversion, Image CDN setup, dashboard tour, and endpoint map.
Choose your path
Build with the API
Learn the core media API concepts, request formats, supported outputs, and production patterns.
Optimize with Image CDN
Transform images and video at the edge with
@convertly-sh/image, Transform Lab, and origin or storage-backed URLs.Use the dashboard
Tour Assets, Transform Lab, Forma AI, workflows, and integrations before you write code.
Build workflows
Chain convert, compress, storage, and webhook steps with test and live runs.
Connect AI agents
Let Claude, Codex, Cursor, and other MCP clients convert and organize approved local folders.
SDKs and clients
Use the official SDKs when you want typed helpers for uploads,sourceUrl, async jobs, polling, and media tools. Use the REST API directly when you need full control over request handling.
JavaScript / TypeScript
Install
@convertly-sh/sdk for Node.js apps, workers, and full-stack TypeScript projects.PHP
Use
convertly/convertly-php for Laravel, WordPress, and server-side PHP integrations.REST API
Call Convertly directly with multipart uploads, JSON utility requests, and API keys.
OpenAPI & other languages
Use
openapi.json with your HTTP client or codegen tool when you are not on JS/PHP.Documentation index
Authentication
Send API keys with bearer tokens or
x-api-key headers.Media conversion
Convert images, video, audio, and archives into production-ready formats.
Image CDN
Resize, re-encode, smart-crop, and cache images and video through delivery URLs or framework SDKs.
Media tools
Explore thumbnails, PDF previews, background removal, GIFs, metadata, and transforms.
Async jobs
Upload larger batches, let workers process them, and poll status until results are ready.
Dashboard workflows
Learn where to start in the hosted app before moving repeated work into the API.
API reference
Inspect request fields, response schemas, and playground examples.
Plan limits
Quotas for storage, CDN, streaming, Forma AI, and media API requests.