# Быстрый старт

> ClearLogo — это HTTP API, которое возвращает чистое изображение логотипа с корректным соотношением сторон и прозрачным фоном для любого домена через один GET-запрос. Для запросов низкого объёма вход не требуется; для боевого трафика используется браузерный или серверный ключ.

## 1. Попробуйте без ключа

Endpoint открыт для низкого объёма запросов. Передайте домен и получите PNG сразу же.

```
GET https://api.clearlogo.dev/logo/github.com?size=128&content=80
```

Или вставьте прямо в HTML:

```html
<img src="https://api.clearlogo.dev/logo/github.com?size=64&content=80" alt="GitHub" />
```

## 2. Получите ключ для боевого использования

Создайте его из панели управления. Выберите тип в зависимости от того, откуда будет идти запрос:

- **Браузерный ключ** — Вставляйте прямо в теги `<img>`. Запросы проверяются против списка разрешённых доменов на ключе.
- **Серверный ключ** — Отправляйте как `Authorization: Bearer …`. Храните на бэкенде — никогда не отправляйте в браузер.

[Войдите, чтобы создать ключ](https://clearlogo.dev/login?lang=ru#cta=sign_in_create_key)

## 3. Настройте выходные данные

Три параметра контролируют большинство результатов: `size`, `content` (занимаемое логотипом пространство внутри канваса) и `theme` (светлый/тёмный вариант). [Откройте тестовую среду](https://clearlogo.dev/ru/docs/playground), чтобы предпросмотреть комбинации перед копированием финального URL.

## Дальнейшие шаги

- [Тестовая среда](https://clearlogo.dev/ru/docs/playground) — Попробуйте все параметры и скопируйте точный URL, который будете использовать.
- [Получить API-ключ](https://clearlogo.dev/login?lang=ru#cta=get_api_key_card) — Войдите и создайте публичный или секретный ключ для боевого трафика.
- [Справочник API](https://clearlogo.dev/ru/docs/api) — Изучите endpoint, параметры, способы аутентификации и поведение rate-limit.
