# 快速开始

> ClearLogo 是一个 HTTP API,通过单次 GET 请求为任何域名返回干净、比例合适、透明背景的 logo 图像。低流量浏览无需登录;生产流量使用浏览器密钥或服务器密钥。

## 1. 无需密钥即可尝试

该端点对低流量浏览开放。输入域名,立即获得 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=zh#cta=sign_in_create_key)

## 3. 调整输出

三个参数控制大部分结果:`size`(大小)、`content`(canvas 内的 logo 占比)和 `theme`(亮色/暗色变体)。 [打开演练场](https://clearlogo.dev/zh/docs/playground) 在复制最终 URL 之前预览组合。

## 下一步

- [演练场](https://clearlogo.dev/zh/docs/playground) — 在线尝试每个选项并复制您要使用的精确 URL。
- [获取 API 密钥](https://clearlogo.dev/login?lang=zh#cta=get_api_key_card) — 登录并创建公开密钥或私密密钥用于生产流量。
- [API 参考](https://clearlogo.dev/zh/docs/api) — 查看端点、参数、认证方式和速率限制行为。