인증
키를 보호하고 올바른 헤더를 사용합니다.
API 키는 환경 변수에 저장하세요. 소스 코드, URL, 스크린샷, 로그에 넣지 마세요. 신뢰할 수 있는 서버에만 전송하고 유출되면 교체하세요.
예제에 필요한 라이브러리와 지원 런타임을 준비하고 환경에 STALI_API_KEY를 설정하세요. 예제 모델을 프로토콜에 맞는 현재 사용 가능한 모델로 바꾸세요.
인증
인증 헤더 두 유형 모두 지원됩니다. 어느 것을 사용해도 무방합니다:
인증 방식은 하나만 보내세요. 두 헤더가 모두 있으면 x-api-key가 우선합니다. Bearer 키가 올바르더라도 x-api-key의 잘못된 키로 인해 401이 발생할 수 있습니다.
x-api-key: sk-apv-...
Authorization: Bearer sk-apv-...새 키는 인증용 해시와 소유자가 대시보드에서 복사하거나 확인할 수 있도록 AES-256-GCM 암호화로 저장됩니다. 이 기능 이전에 생성된 이전 키는 복구할 수 없습니다. 계정당 최대 10개의 키를 동시에 활성화할 수 있습니다.
각 머신 또는 각 애플리케이션마다 별도의 키를 생성하는 것이 좋습니다. 키가 유출되면 해당 키만 폐기하면 되고, 사용량 페이지에서 각 키별로 비용을 분리할 수 있습니다. Git에 푸시하는 소스 코드에 키를 붙여넣지 마세요. 환경 변수나 코드 저장소 외부의 구성 파일에 두세요.
예제는 소스 검토와 로컬 점검 대상이며 모든 앱 버전의 실제 검증을 의미하지 않습니다. 운영 전에 설정, 작은 요청, 사용량을 확인하세요.