> ## 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.

# Introduction

> Welcome to the sCloud CDN V2 API

## 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:

| Purpose               | Base URL                         | Body Limit | Restriction |
| --------------------- | -------------------------------- | ---------- | ----------- |
| **Standard Endpoint** | `https://cdn.sacul.cloud`        | 100MB      | None        |
| **Storage Endpoint**  | `https://upload-cdn.sacul.cloud` | 5GB        | POST Only   |

<Note>
  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.
</Note>

<Warning>
  The `upload-cdn.sacul.cloud` endpoint strictly accepts `POST` requests for file uploads. All other request types (GET, HEAD, DELETE, etc.) will be rejected.
</Warning>

## Endpoints

* [Get/Stream Object](/api-reference/retrieve)
* [Upload Object](/api-reference/upload)
* [Rename Object](/api-reference/rename)
* [Delete Object](/api-reference/delete)
* [Search Objects](/api-reference/search)
* [List Objects](/api-reference/list-objects)
* [Presigned URLs](/api-reference/presigned-urls)

## Authentication

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

### Selection Methods

1. **Authorization Header (Recommended)**
   ```bash theme={null}
   Authorization: Bearer YOUR_API_KEY
   ```

2. **X-API-Key Header**
   ```bash theme={null}
   X-API-Key: YOUR_API_KEY
   ```

3. **Query Parameter**
   ```bash theme={null}
   ?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.

| Plan         | POST/Management Limit |
| :----------- | :-------------------- |
| **Free**     | 100 req/min           |
| **Starter**  | 300 req/min           |
| **Pro**      | 1,000 req/min         |
| **Business** | Custom                |

<Note>
  GET requests for file delivery are unlimited but subject to standard security measures.
</Note>