API 인증

Rivya API는 서버 간 접근에 API 키를 사용합니다.

API 키는 브라우저 로그인 세션과 다릅니다. 쿠키, Better Auth 세션 상태 또는 개인 브라우저 토큰을 Public API 인증 정보로 사용하지 마세요.

헤더 형식

API 키를 Authorization 헤더에 보내세요.

Authorization: Bearer rvya_sk_...

전체 키는 생성할 때 한 번만 표시됩니다. Rivya는 전체 비밀 키가 아니라 해시와 식별 가능한 접두사만 저장합니다.

API 키 만들기

1. Rivya에 로그인합니다.

2. API 키 설정을 엽니다.

3. 필요한 권한 범위로 키를 만듭니다.

4. 전체 키를 즉시 복사합니다.

5. 서버 측 비밀 정보 관리 도구나 환경 변수에 저장합니다.

키를 클라이언트 측 JavaScript, 모바일 앱 번들, 공개 저장소, 분석 이벤트 또는 로그에 넣지 마세요.

현재 권한 범위

첫 버전에는 다음 권한 범위가 문서화되어 있습니다.

• models:read

• generations:create

• generations:read

• files:create

• files:read

• credits:read

• webhooks:manage

• chat:create

• chat:read

설정에서 새로 만든 키에는 문서화된 권한 범위가 기본으로 포함됩니다. 예전에 만든 키는 Files API, API 웹훅 또는 Chat API를 사용하기 전에 새로 만들어야 할 수 있습니다.

폐기와 교체

API 키가 노출된 경우 다음 순서로 교체하세요.

1. 설정에서 이전 키를 폐기합니다.

2. 새 키를 만듭니다.

3. 서버 측 비밀 정보를 업데이트합니다.

4. GET /api/v1/credits로 새 키가 작동하는지 확인합니다.

5. 빌드 시스템, 로그와 배포 변수에서 이전 키를 제거합니다.

폐기된 키를 사용하면 api_key_revoked가 반환됩니다.

인증 오류

일반적인 인증 오류는 다음과 같습니다.

• api_key_missing

• api_key_invalid

• api_key_revoked

• api_key_expired

• api_scope_denied

• public_api_disabled

전체 공개 오류 표는 API 오류와 제한을 참고하세요.

관련 페이지

• API 빠른 시작

• API 크레딧

• API 오류와 제한

• Rivya의 인증과 접근