# 빠른 시작

> ClearLogo 는 한 번의 GET 요청으로 어떤 도메인이든 배경이 깔끔하고 비율이 맞는 로고 이미지를 돌려주는 HTTP API 입니다. 낮은 볼륨 테스트는 로그인 없이도 가능하며, 프로덕션 트래픽은 브라우저 키 또는 서버 키를 사용합니다.

## 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=ko#cta=sign_in_create_key)

## 3. 결과 다듬기

대부분의 결과는 `size`, `content`(캔버스 안에서 로고가 차지하는 비율), `theme`(라이트/다크 변형) 세 값으로 조정됩니다. [플레이그라운드 열기](https://clearlogo.dev/ko/docs/playground)로 조합을 미리 확인한 뒤 최종 URL을 복사하세요.

## 다음 단계

- [플레이그라운드](https://clearlogo.dev/ko/docs/playground) — 옵션을 바로 바꿔보면서 실제로 쓸 URL을 그대로 복사하세요.
- [API 키 발급](https://clearlogo.dev/login?lang=ko#cta=get_api_key_card) — 프로덕션 트래픽용 public 또는 secret 키를 로그인 후 만들 수 있습니다.
- [API 레퍼런스](https://clearlogo.dev/ko/docs/api) — 엔드포인트, 파라미터, 인증 방식, 레이트 리밋 동작을 확인하세요.