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

# Redimensione e converta imagens na hora com o Blob Storage

> Redimensione, recorte e converta imagens públicas adicionando parâmetros de query à URL; disponível a partir do plano Scale, com limite mensal.

Para **imagens públicas**, adicione parâmetros de query à URL do arquivo e a plataforma devolve uma cópia redimensionada ou convertida, servida pela CDN:

```text theme={null}
https://blob.vertracloud.dev/<namespace>/images/logo.png?w=400&h=300&fit=cover&format=webp&q=80
```

| Parâmetro | Significado |
| - | - |
| `w`, `h` | Largura e altura de destino em pixels, de `1` a `4096` |
| `fit` | Como a imagem preenche a caixa: `scale-down`, `contain`, `cover`, `crop` ou `pad` |
| `format` | Formato de saída: `webp`, `avif`, `jpeg`, `png` ou `auto` (escolhe AVIF ou WebP pelo cabeçalho `Accept` do navegador) |
| `q` | Qualidade, de `1` a `100` |

Parâmetros inválidos ou desconhecidos são ignorados. Somente imagens públicas JPEG, PNG, WebP, AVIF e GIF são transformadas; SVG e outros arquivos são sempre servidos como foram guardados.

```bash cURL theme={null}
curl -o logo-400.webp "https://blob.vertracloud.dev/<namespace>/images/logo.png?w=400&format=webp"
```

```javascript JavaScript theme={null}
const url = blob.imageUrl(obj, { width: 400, format: "webp" });
```

```python Python theme={null}
url = obj["url"] + "?w=400&format=webp"
```

```go Go theme={null}
url := *obj.URL + "?w=400&format=webp" // URL é nil para um objeto privado
```

## Planos e limites mensais

As transformações de imagem começam no plano **Scale**. No Economy e no Pro, a URL com parâmetros serve a imagem original.

| Plano | Transformações por mês |
| - | - |
| Economy, Pro | não incluso |
| Scale | 600 |
| Intermediary | 1.000 |
| Enterprise-4 | 1.500 |
| Enterprise-6 | 2.000 |
| Enterprise-8 | 2.500 |
| Enterprise-12 e 14 | 4.000 |
| Enterprise-16 a 24 | 5.000 |
| Enterprise-26 a 32 | 10.000 |

Só transformações **únicas** contam: a mesma imagem com os mesmos parâmetros conta uma vez por mês, e as requisições repetidas atendidas pelo cache não contam para o limite. Depois do limite, a URL continua funcionando e serve a imagem **original**, sem erro. Seu uso no mês é `image_transformations_used` em [Obter estatísticas](https://docs.vertracloud.app/api-reference/endpoint/blob/account/stats.md).

Imagens privadas nunca são transformadas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.