인증

모든 Lurus API 요청에는 인증이 필요합니다. 상호 보완적인 두 가지 모드를 지원하며, 상황에 따라 하나를 선택합니다.

API Key 가장 빠른 시작

Bearer Token으로, 스크립트와 개인 프로젝트에 적합합니다. 본 페이지에서 주로 다룹니다.

OIDC / OAuth2 Token

통합 신원 체계 기반으로, 사용자 로그인이 필요한 애플리케이션, 기업 SSO, M2M에 적합합니다. OIDC 통합 및 PAT / JWT를 참고하세요.

인증 방식

Bearer TokenBearer TokenHTTP 인증 방식의 하나로, 요청 헤더에 "Bearer sk-xxx" 형식으로 자격 증명을 담아 전달합니다.을 사용하여 HTTP Header에 API KeyAPI KeyAPI에 접근하기 위한 비밀 자격 증명으로, 비밀번호와 유사합니다. 각 Key마다 할당량과 권한을 개별 설정할 수 있습니다.더 알아보기 →를 담습니다.

Authorization: Bearer sk-your-api-key

요청 예시

curl https://hub.lurus.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "Hi"}]}'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://hub.lurus.cn/v1",
    api_key="sk-your-api-key",  # 建议改为 os.environ.get("LURUS_API_KEY")
)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://hub.lurus.cn/v1',
  apiKey: 'sk-your-api-key',  // 建议改为 process.env.LURUS_API_KEY
});

전체 SDK 목록은 API 개요 — SDK 지원을 참고하세요.

환경 변수

API Key는 하드코딩을 피하기 위해 환경 변수에 저장하는 것을 권장합니다.

# .env
LURUS_API_KEY=sk-your-api-key

import os
from openai import OpenAI

client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key=os.environ.get("LURUS_API_KEY"))

인증 오류

상태 코드	code	type	흔한 원인
401 Unauthorized	invalid_api_key	authentication_error	Key 형식 오류 / 비활성화 또는 삭제됨 / Authorization Header 형식이 올바르지 않음
403 Forbidden	access_denied	authorization_error	Key에 해당 모델 권한 없음 / 계정이 정지됨 / 할당량 소진

오류 응답 JSON 구조와 재시도 전략은 오류 처리를 참고하세요.

보안 모범 사례

환경 변수 사용

코드에 API Key를 하드코딩하지 않기

비공개 유지

Git 저장소에 커밋하지 않기

권한 제한

Key에 필요한 최소 권한만 부여하기

정기 교체

주기적으로 API Key 교체하기

로그 모니터링

API 호출 로그를 정기적으로 점검하기

---

다음 단계

Chat Completions API오류 처리API 개요OIDC 통합