플랫폼 API 메뉴인증

인증

관리 API 키를 Authorization 헤더의 Bearer 토큰으로 보내세요.

플랫폼 API는 모델 호출용 키와 분리된 관리 API 키로 인증합니다.

두 API 키 구분하기

플랫폼 API는 관리 API 키(Management Key, mk_...)를 사용합니다. 모델 추론에 쓰는 AI 게이트웨이 API 키(sk_...)로는 플랫폼 API를 호출할 수 없습니다.

관리 API 키와 AI 게이트웨이 API 키를 같은 값이나 같은 변수 이름으로 재사용하지 마세요. 두 키는 호출 대상과 권한 경계가 다릅니다.

현재 스페이스의 Admin만 관리 API 화면에서 관리 API 키를 발급하고 복사하거나 재발급할 수 있습니다. Member에게는 키 관리 화면과 값이 제공되지 않습니다.

키가 아직 없으면 발급하기를 선택합니다. 기존 키가 노출되었거나 교체가 필요하면 재발급을 선택합니다.

재발급이 성공하면 이전 키는 즉시 무효화됩니다. 두 키를 함께 쓰는 전환 기간은 제공되지 않으므로, 재발급 직후 모든 서버와 자동화의 값을 새 키로 교체하세요.

모든 플랫폼 API 요청은 https://openapi.letsur.ai/v1 아래의 엔드포인트로 보내고, 관리 API 키를 Authorization 헤더에 넣습니다.


Authorization: Bearer mk_...

예를 들어 월별 사용량은 다음 형식으로 요청합니다.


curl 'https://openapi.letsur.ai/v1/usage?month=2026-08' \
  --header 'Authorization: Bearer mk_...'

관리 API 키는 서버의 비밀 변수 또는 환경 변수에 저장하고 브라우저 코드, 공개 저장소와 로그에 노출하지 않습니다. 예시의 mk_...는 자리 표시자이며 실제 키를 문서나 이슈에 붙여 넣지 않습니다.

키를 재발급했다면 이전 키를 사용하는 연동이 없는지 함께 확인합니다.