API 키
API용 키를 만들고, 범위를 정하고, 관리합니다.
API 키는 Reverie Open API로 가는 요청을 인증합니다. 키는 설정 → 더보기 → API 키에 있고, Labs의 Open API 타일도 바로 여기를 가리킵니다. 어떤 계정이든 만들 수 있습니다 — 등급 조건도 없고, 몇 개까지라는 상한도 없습니다.
키 만들기
새 API 키 생성 누르기
페이지가 비어 있을 때는 버튼에 첫 번째 API 키 생성이라고 적혀 있습니다.
이름 붙이기
이름은 필수이고 1–100자입니다. 목록과 사용 통계에서 이 키가 어떻게 표시될지를 정합니다 — "거실 스피커", "staging worker"처럼요.
전체로 할지 특정 캐릭터로 할지 고르기
캐릭터 선택은 전체 (모든 캐릭터) 또는 특정 캐릭터 중 하나를 고르는 것이지, 있어도 그만인 항목이 아닙니다. 특정 캐릭터를 고르면 그 캐릭터가 이 키에 고정됩니다.
원하면 기기 유형과 만료도
기기 유형은 자유 입력입니다(speaker, phone, iot). 만료는 날짜와 시각을 함께 받고, 그 순간이 되면 키는 저절로 멈춥니다.
키는 곧바로 rk_ 뒤에 16진수 64자가 붙은 모습으로 나타납니다.
키는 언제든 다시 볼 수 있습니다
한 번만 보여주고 마는 비밀이 아닙니다. 키가 남아 있는 한 그 카드에는 언제나 API 키 표시, API 키 숨기기, API 키 복사가 있습니다.
온전한 비밀 값이 설정에서 계속 읽히므로, 계정 접근을 곧 키 접근이라고 여기세요. 키는 서버나 비밀 관리 도구에 두고, 소스 관리나 브라우저 코드에는 절대 넣지 마세요.
전역 키와 고정된 키
| 전체 (모든 캐릭터) | 특정 캐릭터 | |
|---|---|---|
GET /models가 돌려주는 것 | 당신의 최근 캐릭터 | 그 캐릭터의 시나리오, 하나도 없으면 캐릭터 자체 |
model을 생략하면 | 가장 최근 대화로 떨어집니다 | 고정된 캐릭터를 씁니다 |
| 짧은 시나리오 ID | 절대 풀리지 않습니다 | 고정된 캐릭터를 기준으로 풀립니다 |
비활성화, 삭제, 교체
| 동작 | 효과 | 되돌릴 수 있나 |
|---|---|---|
| 활성 토글 | 꺼져 있는 동안 그 키를 쓴 요청은 거부됩니다 | 예 |
| 삭제 | 키가 사라지고, 그것을 쓰던 프로그램은 접근을 잃습니다 | 아니요 |
별도의 취소 동작은 없습니다 — 비활성화와 삭제, 이 둘뿐입니다.
키 삭제는 되돌릴 수 없고, 그 키의 실적까지 함께 가져갑니다. 지난 트래픽은 사용 통계의 삭제된 키 묶음으로 옮겨가고, 그때부터는 어느 연동이 얼마를 썼는지 알 수 없습니다. 기록이 필요할 것 같으면 먼저 비활성화하세요.
교체하려면 대체할 키를 만들고, 배포한 다음, 옛 키를 비활성화하거나 삭제하세요. 자동 교체는 없고 만료 뒤의 유예도 없습니다 — 만료된 키는 다음 요청에서 api_key_expired로 거부됩니다.
범위
키에는 범위가 붙어 있지만, 생성 창은 그것을 보여주지 않습니다. 설정에서 만든 키는 대화 관련 엔드포인트만 호출할 수 있습니다.
캐릭터 가져오기 엔드포인트는 다른 범위가 필요하고, 그런 키를 얻는 유일한 길은 Labs → 캐릭터 가져오기 스킬을 여는 것입니다. 거기서 Reverie Character Importer (Skill) 이름으로 키가 만들어집니다. 설정에서 만든 평범한 키로 가져오기를 호출하면 403이 돌아옵니다. 캐릭터 가져오기 →
사용 통계
같은 페이지의 사용 통계 패널은 요청, 토큰, 크레딧, 활성 키를 UTC 날짜별로 묶어 보여주고, 키별 사용량 아래에 키마다의 내역을 펼쳐 줍니다. 키 하나로 걸러 보거나 모든 키로 볼 수 있고, 기간은 7일에서 90일까지 — 기본은 30일입니다. API로 만들어진 대화만 집계됩니다.
키별 지출을 볼 수 있는 곳은 이 패널뿐입니다. 크레딧 기록에는 메시지마다 얼마가 들었는지 남지만 어느 키가 쓴 것인지는 적히지 않으므로, 연동끼리 견줄 때는 여기 통계를 쓰세요.
요청 만들기
요청 만들기를 누르면 생성기가 열립니다. 활성 키 하나를 고르고, 그 키가 볼 수 있는 목록에서 캐릭터나 시나리오를 고르고, 메시지를 적고, 스트리밍과 temperature를 정하면, 바로 돌아가는 cURL, TypeScript, Python을 복사할 수 있습니다.
그 키는 브라우저 안에서 캐릭터 목록을 불러오는 데만 쓰입니다. 만들어진 코드는 비밀 값을 박아 넣지 않고 환경에서 REVERIE_API_KEY를 읽습니다.
한도
| 한도 | 값 |
|---|---|
| 계정당 키 개수 | 제한 없음 |
| 키별 요청 제한 | 없음 |
| 키별 동시 실행 상한 | 없음 |
| 실제로 사용량을 묶는 것 | 크레딧 잔액, 그리고 무료 모델 창 |
관련 문서
- Open API — 엔드포인트, 요청 형태, 오류
- 캐릭터 가져오기 — 가져오기용 키가 무엇을 위한 것인지
- Reverie Labs — Open API와 가져오기 타일
- 보안 — 계정의 나머지 접근 설정