Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sacul.cloud/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
PurposeBase URLBody LimitRestriction
Standard Endpointhttps://cdn.sacul.cloud100MBNone
Storage Endpointhttps://upload-cdn.sacul.cloud5GBPOST Only
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) 
    Authorization: Bearer YOUR_API_KEY
  2. X-API-Key Header 
    X-API-Key: YOUR_API_KEY
  3. Query Parameter 
    ?apiKey=YOUR_API_KEY

​
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.
PlanPOST/Management Limit
Free100 req/min
Starter300 req/min
Pro1,000 req/min
BusinessCustom
GET requests for file delivery are unlimited but subject to standard security measures.