# Quickstart

> ClearLogo ist eine HTTP-API, die für jede Domain ein sauberes, proportionsgerechtes Logobild als opakes Quadrat auf einem themengerechten Hintergrund (weiß für hell, ein dunkles Neutral für dunkel) über eine einzelne GET-Anfrage zurückgibt. Für geringes Volumen ist keine Anmeldung erforderlich; Produktionsverkehr verwendet einen Browser- oder Server-Schlüssel.

## 1. Testen ohne Schlüssel

Der Endpoint ist für geringes Volumen offen. Geben Sie eine Domain ein und Sie erhalten sofort eine PNG zurück.

```
GET https://api.clearlogo.dev/logo/github.com?size=128&frame=fill&padding=10
```

Oder fügen Sie sie direkt in HTML ein:

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


## 2. Schlüssel für die Produktion abrufen

Erstellen Sie einen vom Dashboard. Wählen Sie einen Modus basierend darauf, wo die Anfrage ausgeführt wird:

- **Browser-Schlüssel** — Fügen Sie ihn direkt in `<img>`-Tags ein. Aufrufe werden gegen die auf dem Schlüssel zulässigen Domains überprüft.
- **Server-Schlüssel** — Senden Sie ihn als `Authorization: Bearer …`. Behalten Sie ihn in Ihrem Backend — versenden Sie ihn niemals an einen Browser.

[Melden Sie sich an, um einen Schlüssel zu erstellen](https://clearlogo.dev/login?lang=de#cta=sign_in_create_key)

## 3. Die Ausgabe anpassen

Einige Regler steuern die meisten Ergebnisse: `size`, `frame` (`fill` füllt die Canvas, `original` bewahrt die ursprüngliche Rahmung des Quell-Icons), `padding` (Rand je Seite), `shape` (`square` oder `circle`) und `theme` (helle oder dunkle Variante, die auch die Farbe des opaken Hintergrunds bestimmt). [Öffnen Sie den Playground](https://clearlogo.dev/de/docs/playground), um Kombinationen in der Vorschau anzusehen, bevor Sie die endgültige URL kopieren.

## Nächste Schritte

- [Playground](https://clearlogo.dev/de/docs/playground) — Testen Sie alle Optionen live und kopieren Sie die genaue URL, die Sie verwenden werden.
- [API-Schlüssel abrufen](https://clearlogo.dev/login?lang=de#cta=get_api_key_card) — Melden Sie sich an und erstellen Sie einen öffentlichen oder privaten Schlüssel für Produktionsverkehr.
- [API-Referenz](https://clearlogo.dev/de/docs/api) — Sehen Sie den Endpoint, Parameter, Authentifizierungsmodi und das Rate-Limit-Verhalten.
