Skip to main content

​
Welcome

sCloud CDN V2 offers a powerful, high-performance API for content delivery, fuzzy search, and secure file management. Built on Bun and ElysiaJS, it provides sub-100ms response times with native S3 and Meilisearch integration.

​
Base URLs

The API is split across two domains to optimize for delivery performance and large file uploads:
The cdn.sacul.cloud domain is proxied by Cloudflare and has a request body limit of 100MB. For larger files, please use the upload-cdn.sacul.cloud endpoint.
The upload-cdn.sacul.cloud endpoint strictly accepts POST requests for file uploads. All other request types (GET, HEAD, DELETE, etc.) will be rejected.

​
Endpoints

​
Authentication

All management operations (Upload/Delete/Search/List) require an API Key. Content delivery (GET) is public.

​
Selection Methods

  1. Authorization Header (Recommended)
  2. X-API-Key Header
  3. Query Parameter

​
Performance Headers

Every response includes timing headers for transparency:
  • X-Response-Time: Total time spent in the API.
  • X-S3-Time: Time spent communicating with the storage backend.

​
Rate Limits

We implement rate limiting to ensure stability. Limits vary by your subscription plan.
GET requests for file delivery are unlimited but subject to standard security measures.