API Key 발급
계정에 가입하고 첫 번째 Key를 생성하세요
3분이면 사용 가능한 API Key를 받습니다.
OIDC / OAuth 연동
최종 사용자가 Lurus 계정으로 자체 앱에 로그인하게 하거나, 백엔드가 Service User + JWT Profile로 호출하려면 통합 ID 인증으로 전환할 수 있습니다: OIDC / OAuth2 연동 · API 인증(PAT/JWT). API Key와 OIDC Token은 공존하며 두 가지 모두 유효합니다.
가입과 Key 생성
Lurus 콘솔 접속 →「회원가입」→ 이메일·비밀번호 입력 → 이메일 인증 완료.
로그인 → 왼쪽「토큰 관리」→「새 토큰 생성」→ 토큰 이름 입력(식별하기 쉽게) → 확인.
한 번만 표시됨
생성 후 즉시 API Key를 복사해 저장하세요. 한 번만 표시됩니다!
API Key 형식
sk-로 시작하며 48자리 랜덤 문자열입니다: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
API Key 관리
사용량 확인
「토큰 관리」페이지에서 각 Key의 사용된 한도, 남은 한도, 최근 호출 시각을 표시합니다.
비활성화 / 삭제
비활성화 = 사용 권한 일시 중지(복구 가능); 삭제 = 영구 삭제(복구 불가).
모델 권한 설정
Key 옆「편집」클릭 →「사용 가능 모델」에서 허용할 모델 선택 → 저장.
보안 권장 사항
Key를 비밀번호처럼 관리하세요
유출 금지(공개 저장소에 커밋하지 않기); 90일마다 Key 교체; 최소 권한(필요한 모델만 부여); 호출 로그를 정기적으로 점검해 이상을 발견하면 즉시 대응.
자주 묻는 질문
Key를 잊어버렸으면 어떻게 하나요?
복구할 수 없으며, 새 Key를 생성하세요.
Key가 도용되었나요?
해당 Key를 즉시 비활성화하거나 삭제하고 새 Key를 생성하세요.