> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Armazenamento serverless - Square Cloud Blob Storage

> Armazenamento serverless escalável com CDN global, zero taxas de transferência e 99.999999999% de disponibilidade. Blob Storage da Square Cloud - ideal para aplicações que precisam de storage confiável.

<Frame>
  <img src="https://cdn.squarecloud.app/docs/services/pt-br/blob.webp" alt="Visão geral do serviço Blob Storage da Square Cloud" style={{ borderRadius: "0.2rem" }} />
</Frame>

## Porque escolher o Blob Storage da Square Cloud?

Como a **maior plataforma de hospedagem de bots da América Latina**, confiada por **80 dos 100 maiores servidores do Discord brasileiro**, criamos o Blob Storage como resposta às **limitações aplicadas pelo Discord em sua CDN**. Nossa solução empresarial robusta garante **estabilidade e disponibilidade** para milhares de desenvolvedores que precisam de armazenamento confiável para seus ativos.

Resumidamente, o **Blob Storage** é um **serviço de armazenamento serverless** da Square Cloud, **rápido e escalável**, com **cotas generosas** incluídas em cada plano e um **modelo flexível Pay as you go** para o uso excedente.

<Note>Blob atualmente em beta. Se você tiver algum feedback, por favor [entre em contato](https://squarecloud.app/pt-br/support).</Note>

## Recursos Principais

<CardGroup cols={2}>
  <Card title="Sem Taxas de Transferência" icon="money-bill">
    **Zero taxas de ingress/egress** - transferência de dados gratuita.
  </Card>

  <Card title="Infraestrutura Gerenciada" icon="server">
    **Orquestração automática** de recursos com **provisionamento dinâmico**.
  </Card>

  <Card title="CDN Global de Alto Desempenho" icon="globe">
    **Distribuição otimizada** através da rede global Cloudflare com **edge caching**.
  </Card>

  <Card title="Limites Escaláveis" icon="chart-line">
    **Até 1PB de armazenamento** e **1 bilhão de requests/dia gratuitos** disponíveis.
  </Card>
</CardGroup>

## Cotas e Preços

O Blob Storage da Square Cloud oferece uma estrutura de preços clara e transparente, permitindo que você escolha o plano que melhor se adapta às suas necessidades.

### Cotas Inclusas

Cada plano pago inclui uma **cota gratuita** de armazenamento sem custos adicionais:

| Plano      | Armazenamento Gratuito Incluído |
| ---------- | ------------------------------- |
| Hobby-1    | **5 GB**                        |
| Hobby-2    | **15 GB**                       |
| Standard-4 | **30 GB**                       |
| Standard-6 | **50 GB**                       |
| Standard-8 | **100 GB**                      |
| Pro-12     | **200 GB**                      |
| Pro-16     | **250 GB**                      |
| Enterprise | **250 GB**                      |

### Preço Excedente (Pay as you go)

Caso seu uso ultrapasse a cota incluída no seu plano, você entra automaticamente no modelo **Pay as you go**, pagando **apenas pelo espaço extra** que utilizar.

<Card title="Custo do Armazenamento Excedente" icon="coins">
  **R\$ 0,25 por GB extra** utilizado além da sua cota gratuita.
</Card>

<Info>O serviço de **Blob Storage** e a funcionalidade **Pay as you go** estão disponíveis **exclusivamente** para assinantes de **planos pagos**.</Info>

## Extensões de Arquivo Suportadas

Nossa plataforma implementa uma **whitelist rigorosa de tipos MIME** para garantir a **segurança e integridade** do serviço. Esta restrição de extensões é uma **medida de segurança essencial** que previne o upload de arquivos maliciosos e garante conformidade com **políticas de segurança corporativa**.

| Categoria     | Extensões Suportadas                                                                                |
| ------------- | --------------------------------------------------------------------------------------------------- |
| **Vídeo**     | `.mp4`, `.mpeg`, `.webm`, `.flv`, `.m4v`                                                            |
| **Imagem**    | `.jpg`, `.png`, `.apng`, `.tiff`, `.gif`, `.webp`, `.bmp`, `.svg`, `.ico`, `.cur`, `.heic`, `.heif` |
| **Áudio**     | `.wav`, `.ogg`, `.opus`, `.m4a`, `.mp3`, `.aac`                                                     |
| **Texto**     | `.html`, `.css`, `.csv`, `.txt`, `.sql`                                                             |
| **Aplicação** | `.xml`, `.sql`, `.sqlite3`, `.p12`, `.pdf`, `.json`, `.js`                                          |

<Warning>
  **Validação de tipo MIME**: Todos os arquivos passam por **verificação de assinatura binária** para prevenir **spoofing de extensões** e **uploads maliciosos**.
</Warning>

<Note>Para solicitar suporte a tipos de arquivo adicionais ou discutir casos de uso específicos, [entre em contato](https://squarecloud.app/pt-br/support) com nossa equipe técnica.</Note>

## Performance e Benchmarks

Nossa infraestrutura foi submetida a **benchmarks extensivos** para garantir que a **Square Cloud** seja uma **solução de armazenamento serverless robusta e confiável**. Aqui estão algumas das principais descobertas dos nossos testes:

* **Latência**: A latência média para recebimento de arquivos é de **\~11ms**.
* **Taxa de Transferência**: A taxa de transferência média é de **\~12,5-18,75MB/s (100-150Mbps)** em conexões convencionais, alcançando **até \~500Mbit/s** em ambientes com conectividade >1-2Gbit/s.
* **Disponibilidade**: A disponibilidade média é de **99,999999999% (11 noves)** (baseado em design S3).

Nos testes internos da Square Cloud, utilizando nossa infraestrutura em Nova York, a **latência é insignificativamente baixa**, **abaixo da latência média**.

<Frame>
  <img src="https://cdn.squarecloud.app/docs/services/blob-global-latency-test.webp" alt="Benchmark de latência global do Blob Storage" style={{ borderRadius: "0.5rem" }} />
</Frame>

<Info>**Importante**: Os resultados de benchmarks são baseados em testes controlados e podem variar significativamente dependendo de fatores como **localização geográfica**, **tamanho dos arquivos**, **qualidade da conexão de rede** e **horário de pico**. Para obter a melhor performance, recomendamos realizar testes específicos em seu ambiente de produção.</Info>
<Warning>**Limitações regionais**: Usuários localizados na **África** e em **algumas regiões da Ásia** podem experimentar latências superiores devido à **distância física dos data centers** e **infraestrutura de rede local**.</Warning>

## Como hospedar meus arquivos?

<Steps>
  <Step title="Upload via Endpoint">
    Envie seus arquivos para o [endpoint post](/pt-br/blob-reference/endpoint/post).
  </Step>

  <Step title="Acesso via URL">
    Acesse seus arquivos pela URL fornecida na resposta do upload.
  </Step>
</Steps>

O processo é **simplificado**: utilize sua chave de API da conta para autenticação e realize uploads através de uma **única requisição HTTPS**. **Não há necessidade de configuração adicional** ou infraestrutura complexa. A **Square Cloud cuida de tudo** para você.
