Question 1

ClearLogo란 무엇인가요?

Accepted Answer

ClearLogo는 모든 도메인에 대해 단일하고 깔끔한 이미지를 반환하는 로고 API입니다. 일반적인 로고 소스와 달리 프레젠테이션에 중점을 두고 있습니다. 모든 응답은 배경 인식 기능이 있으며, 자동으로 자르고 비율에 맞춰져 있어서 대시보드, CRM, 회사 테이블 및 기타 제품 표면에서 로고가 일관되게 표시됩니다.

Question 2

API를 사용해보려면 회원가입이 필요한가요?

Accepted Answer

아니요. https://api.clearlogo.dev/logo/{domain}에 익명 요청을 바로 할 수 있으며 저용량 테스트의 경우 키가 필요하지 않습니다. 프로덕션 트래픽의 경우 대시보드에서 브라우저 키 또는 서버 키를 획득해야 합니다.

Question 3

ClearLogo를 사용하려면 백엔드 서버가 필요한가요?

Accepted Answer

아니요. 브라우저 키를 사용하면 프론트엔드 코드에서 <img> 태그에 로고 URL을 직접 포함할 수 있습니다. 요청은 키에서 구성한 허용 도메인에 대해 Origin/Referer 일치를 통해 검증됩니다. 백엔드에서 Authorization: Bearer 인증을 선호하는 경우에만 서버 키를 사용하세요.

Question 4

어디서 시작해야 하나요?

Accepted Answer

가장 빠른 방법은 playground를 열고 몇 가지 대표적인 도메인을 붙여넣어 UI에서 출력이 어떻게 보이는지 확인하는 것입니다. 만족하면 대시보드에서 프로덕션 키를 만들고 URL을 코드에 교체합니다.

Question 5

ClearLogo의 최고의 사용 사례는 무엇인가요?

Accepted Answer

ClearLogo는 로고가 나란히 배치되고 시각적 일관성이 중요한 곳에 적합합니다. 회사 테이블과 디렉토리, CRM 계정 목록, 강화 UI, 영업 도구 및 내부 대시보드가 그 예입니다. 서버 측 캐시 뒤에 일회성 로고만 필요하고 프레젠테이션 일관성이 문제가 아닌 경우 일반적인 소스로 충분할 수 있습니다.

Question 6

브라우저 키와 서버 키의 차이점은 무엇인가요?

Accepted Answer

브라우저 키(pk_…)는 프론트엔드 코드와 <img> 태그에 포함해도 안전합니다. 요청은 구성한 허용 도메인에 대해 Origin 또는 Referer 헤더를 일치시켜 인증됩니다. 서버 키(sk_…)는 백엔드에서 Authorization: Bearer YOUR_KEY를 통해 인증되며 절대 브라우저에 노출되면 안 됩니다.

Question 7

브라우저 키를 특정 도메인으로 제한하려면 어떻게 해야 하나요?

Accepted Answer

대시보드에서 키 설정을 열고 허용된 도메인만 활성화한 후 도메인을 한 줄에 하나씩 추가합니다. 하위 도메인의 경우 *.example.com과 같은 와일드카드 표기법이 지원됩니다.

Question 8

도메인 제한을 활성화한 후 Referer 헤더가 없는 요청은 어떻게 되나요?

Accepted Answer

차단됩니다. 직접 트래픽과 Referrer-Policy: no-referrer 또는 same-origin으로 전송된 요청은 도메인 제한이 활성화되면 실패합니다. 작동하는 정책은 strict-origin-when-cross-origin, origin, origin-when-cross-origin 및 unsafe-url입니다. 제한을 활성화하기 전에 브라우저의 네트워크 탭에서 img.logo.dev 요청의 Referer 헤더를 확인하여 설정을 검증할 수 있습니다.

Question 9

API 키를 교체하거나 변경하려면 어떻게 해야 하나요?

Accepted Answer

대시보드에서 새 키를 만들고 통합을 업데이트하여 사용한 다음 이전 키를 삭제합니다. 긴급 교체가 필요한 경우 support@clearlogo.dev에 문의하세요.

Question 10

ClearLogo는 어떤 이미지 형식을 반환하나요?

Accepted Answer

png가 기본값입니다. format 쿼리 매개변수를 통해 webp 또는 jpeg을 요청할 수 있습니다. format을 생략하면 API는 Accept 요청 헤더에서 콘텐츠를 협상합니다. 최신 브라우저는 <img>를 통해 로드할 때 자동으로 WebP를 받습니다.

Question 11

"배경 인식" 출력이 무엇을 의미하나요?

Accepted Answer

ClearLogo는 브랜드의 로고가 컬러 또는 어두운 배경용으로 설계되었는지 감지하고 응답 이미지에 해당 배경을 유지합니다. 이는 밝은 표면에서 깨져 보이는 투명 로고의 일반적인 문제를 방지합니다.

Question 12

어떤 크기가 사용 가능한가요?

Accepted Answer

size 매개변수는 16, 32, 48, 64, 96, 128, 192, 256, 512, 1024 픽셀을 허용합니다. 이미지는 항상 정사각형입니다. 기본값은 128px입니다. 이 목록 외 값은 가장 가까운 허용값으로 자동 스냅됩니다 (동률이면 상위 값 선택).

Question 13

`theme` 매개변수는 무엇을 하나요?

Accepted Answer

theme=dark를 설정하면 로고의 다크 배경 변형이 반환됩니다(사용 가능한 경우). 다크 변형이 없으면 API는 표준 버전으로 폴백합니다.

Question 14

속도 제한은 어떻게 되나요?

Accepted Answer

제한은 플랜에 따라 다릅니다. 가격 페이지에서 세부 정보를 확인하세요. 키별 사용량은 X-RateLimit-Limit, X-RateLimit-Remaining 및 X-RateLimit-Reset 응답 헤더에 반환되므로 실시간으로 소비를 모니터링할 수 있습니다.

Question 15

속도 제한을 초과하면 어떻게 되나요?

Accepted Answer

API는 재시도하기 전에 대기할 초 수를 나타내는 Retry-After 헤더와 함께 HTTP 429를 반환합니다. 추가 조치를 취하기 전에 연락드립니다. 경고 없이 서비스가 중단되지 않습니다.

Question 16

현재 사용량을 어떻게 확인하나요?

Accepted Answer

실시간 사용량은 대시보드에서 볼 수 있습니다. 모든 API 응답의 X-RateLimit-Remaining 헤더를 읽을 수도 있습니다.

Question 17

도메인의 로고가 표시되지 않습니다. 무엇을 확인해야 하나요?

Accepted Answer

다음 체크리스트를 진행하세요: (1) 도메인이 https://github.com/이 아닌 github.com과 같이 스키마나 경로 없는 베어 호스트명인지 확인합니다. (2) API 키가 유효하고 만료되지 않았는지 확인합니다. (3) 도메인 제한이 활성화된 경우 Referer 헤더가 전송되는지 확인합니다. (4) 응답 상태 코드를 확인합니다. 404는 해당 도메인의 로고를 찾을 수 없음을 의미하고, 401은 인증 문제를 의미하며, 429는 속도 제한을 의미합니다.

Question 18

도메인의 로고가 잘못되거나 오래되었습니다. 무엇을 할 수 있나요?

Accepted Answer

support@clearlogo.dev에 도메인 이름과 무엇이 잘못되었는지 설명하는 메모를 포함하여 문의하세요. 검토 후 자산을 업데이트합니다.

Question 19

401 오류가 발생합니다. 무엇을 의미하나요?

Accepted Answer

401은 요청이 인증되지 않았음을 의미합니다. 브라우저 키의 경우 token 쿼리 매개변수가 포함되었는지, Origin/Referer 헤더가 허용된 도메인과 일치하는지 확인합니다. 서버 키의 경우 Authorization: Bearer YOUR_KEY 헤더가 있는지, 키가 삭제되지 않았는지 확인합니다.

Question 20

로고는 프로덕션에서 로드되지만 로컬 개발 중에는 로드되지 않습니다. 어떻게 해결하나요?

Accepted Answer

대시보드에서 키의 허용된 도메인에 localhost(또는 localhost:3000, localhost:5173 등)를 추가합니다. API는 정확한 원본과 일치하므로 개발 서버가 표준이 아닌 포트를 사용하는 경우 포트를 포함합니다. 키를 배포하기 전에 로컬 항목을 제거하거나 별도의 개발 키를 만듭니다.

Question 21

브라우저에서 CORS 오류가 나타납니다. 어떻게 해결하나요?

Accepted Answer

API는 관대한 CORS 헤더를 설정하므로 CORS 오류는 일반적으로 진정한 CORS 문제보다는 누락되거나 차단된 Referer 헤더를 나타냅니다. 페이지의 Referrer-Policy를 확인합니다. no-referrer와 같은 정책은 Referer 헤더가 전송되는 것을 방지하므로 도메인 제한이 활성화되면 요청이 실패합니다. 또한 <img> 태그 자체를 확인합니다: 요소의 referrerpolicy="no-referrer" 또는 referrerpolicy="same-origin" 속성은 페이지 수준 정책을 재정의하고 해당 특정 요청에서 Referer를 제거합니다.

Question 22

어떤 플랜을 사용할 수 있나요?

Accepted Answer

ClearLogo는 저용량 사용을 위한 무료 플랜과 프로덕션 트래픽을 위한 유료 플랜을 제공합니다. 가격 페이지에서 현재 플랜 세부 정보 및 요청 제한을 확인합니다.

Question 23

플랜을 업그레이드하려면 어떻게 해야 하나요?

Accepted Answer

대시보드를 방문하고 플랜 카드에서 업그레이드를 선택합니다. 플랜을 선택하고 결제를 완료할 수 있는 청구 페이지로 이동합니다.

Question 24

구독을 취소할 수 있나요?

Accepted Answer

예. 대시보드에서 언제든지 취소할 수 있습니다. 현재 청구 기간이 끝날 때까지 플랜이 유지됩니다.

도움말 & FAQ

시작하기

API 키 & 인증

출력 & 포맷팅

속도 제한 & 사용량

문제 해결

청구 & 플랜

아직 궁금한 점이 있으신가요?