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

# Get/Stream Object

> Fetch or stream a file from a bucket.

Fetch a file from a specific bucket. This endpoint is optimized for high-performance delivery and supports streaming for large files.

## Query Parameters

<ParamField path="bucketName" type="string" required>
  The name of the bucket containing the file.
</ParamField>

<ParamField path="*path" type="string" required>
  The full path to the file within the bucket (e.g., `images/banner.png`).
</ParamField>

## Headers

<ParamField header="Range" type="string">
  Standard HTTP Range header for partial content (e.g., `bytes=0-1023`). Highly recommended for video seeking.
</ParamField>

## Responses

<ResponseField name="200 OK" type="file">
  Standard file delivery.
</ResponseField>

<ResponseField name="206 Partial Content" type="file">
  Returned when a valid `Range` header is provided.
</ResponseField>

<ResponseField name="404 Not Found" type="object">
  Returns a placeholder if configured, or a standard error response.
</ResponseField>

## Examples

```bash Standard Request theme={null}
curl https://cdn.sacul.cloud/my-bucket/images/logo.png
```

```bash Streaming with Range theme={null}
curl -H "Range: bytes=0-1000" https://cdn.sacul.cloud/my-bucket/videos/intro.mp4
```