Dreep FAQ
Dreep is a media API for apps that handle images, video and files. You upload through the API or a presigned URL, transform with URL parameters, and deliver from the Dreep CDN. Files live in Dreep storage or, on paid plans, your own S3-compatible bucket. These answers cover uploads, transforms, video, security, BYOB, limits and pricing.
Uploads, transforms, storage and billing
What is Dreep?
Dreep is a media API for apps that handle user images, video and files. It covers uploads, storage, image and video transformations, delivery through the Dreep CDN, OCR and background removal, with JavaScript and Go SDKs and a REST API. It is built by FUFU SOFTWARES LIMITED.
How do URL transformations work?
Every asset has a delivery URL on cdn.dreep.cloud. Add query parameters such as width, height, fit, format (jpeg, png, webp, avif, gif, tiff), quality (1 to 100, default 80) and gravity, for example ?width=800&height=600&fit=cover&format=webp&quality=80. A variant is generated on the first request and served from cache afterwards. Saved presets let you use ?p=thumbnail instead of repeating parameters.
How do browser and mobile uploads work?
Your API key gives full access to a project, so keep it on your server. For client uploads, your backend requests a presigned upload, the client PUTs the raw bytes to the returned single-use URL within 10 minutes, and your backend confirms it. The Content-Type and Content-Length must match what was presigned. Files can be up to 500 MB each.
What is Bring Your Own Bucket (BYOB)?
On Starter and Pro you can connect your own AWS S3, Cloudflare R2, Wasabi, DigitalOcean Spaces, MinIO or other S3-compatible bucket to a project. Originals and generated variants are stored in your bucket and delivered through Dreep CDN URLs. Connect it when you create the project, because once connected the bucket cannot be changed. Files in your bucket do not count against Dreep storage quota.
How do I keep media private?
Folders are Public, Private or Signed. For Signed folders, the SDKs generate time-limited HMAC-SHA256 signed URLs locally from your project's signing secret, with no network call, for example dreep.signedUrl(asset, { expiresIn: 3600 }). Expiry can also be overridden per asset at upload.
What video processing is supported?
Video uses the same URL model: resize, trim, change frame rate, transcode to MP4, WebM or MOV with H.264, HEVC or VP9, package as HLS, make GIFs, extract audio and take thumbnails. Heavy jobs return 202 while processing. Request the same URL again and it returns the result from cache once ready. There are no webhooks.
How do OCR and background removal work?
Request an image or PDF asset with the .txt extension or format=txt to get its text, or upload and extract in one call with POST /ocr. OCR is billed per page. POST /bg-remove returns the subject on a transparent background as a new asset, which you can then place on any colour with the bg parameter.
Can I import existing files from Cloudinary, S3 or R2?
Yes. The dashboard has importers for Cloudinary, Amazon S3 and Cloudflare R2. Connect the source (for S3 or R2, an access key, secret, endpoint and bucket name), choose what to import, and Dreep copies the files into your project as a background job with progress and logs. It is a one-off import, not an ongoing sync.
Which SDKs are available?
There are two official SDKs: JavaScript/TypeScript (npm install dreep, Node.js 18 or later, zero dependencies) and Go (github.com/IndigoSoftwares21/dreep-go, Go 1.22 or later, standard library only). Any other language can use the REST API directly.
How much does Dreep cost?
Free is $0 with 1 GB storage, 100 image and 20 video transformations a month. Starter is $2.99 a month ($29 a year) with 10 GB, 10,000 image and 1,000 video transformations. Pro is $5.99 a month ($59 a year) with 50 GB, 50,000 image and 4,000 video transformations. Prices are in USD.
What happens when I hit a plan limit?
Requests that would go over a limit fail with the LIMIT_EXCEEDED error code. There is no automatic overage billing. You either upgrade or buy an add-on, such as extra storage from $1.99 a month or a pack of 10,000 image transformations for $1.99.
What does Dreep validate, and what is still my job?
Dreep enforces a file type allow-list, the 500 MB size limit, matching Content-Type and Content-Length on presigned uploads, and single-use upload URLs. API and CDN traffic is served over HTTPS. Deciding which of your users may upload, per-user quotas, content moderation and malware scanning remain your responsibility.
Try it on the free plan
The free plan includes 1 GB of storage, 100 image transformations and 20 video transformations a month.