01
OpenAI 방식 요청
공식 JavaScript/Python SDK를 사용하고 기본 URL만 바꿉니다.
OpenAI 호환 캐릭터 API
앱이 메시지를 보냅니다. 캐릭터가 답합니다.
OpenAI 클라이언트를 Reverie로 연결해 일반 모델 대신 캐릭터를 호출하세요. 성격, 시나리오, 기록과 장기 기억은 서버에 남고 같은 대화를 웹에서도 볼 수 있습니다.
- OpenAI SDK 호환
- 기본 스트리밍
- 서버 측 지속 기록
POST /v1/chat/completions
200 연결됨TypeScript 요청
const reply = await client.chat
.completions.create({
model: "Luna [abc12345]",
messages: [{
role: "user",
content: "천문대를 기억해?"
}],
});캐릭터 응답
스트리밍{
"role": "assistant",
"content": "네가 그곳에서 한 약속을 기억해."
}
기억 저장됨 · 웹 채팅 동기화됨
한 번의 요청, 완전한 캐릭터 엔진
경계에서는 호환되고, 내부에서는 상태를 유지합니다.
익숙한 클라이언트 규격을 유지하며 캐릭터, 맥락, 기억과 영속성은 Reverie가 처리합니다.
02
캐릭터·시나리오 선택
model 필드가 캐릭터, 시나리오 또는 키의 기본값을 고릅니다.
03
성격과 맥락 구성
정의, 시나리오, 설정, 최근 메시지, 요약과 기억을 조합합니다.
04
응답 스트리밍과 저장
SSE 청크를 보내며 대화와 새 기억을 보존합니다.
키별 캐릭터 라우팅
서버 측 연속성
OpenAI 응답 형식
프롬프트 래퍼 그 이상
캐릭터 인프라를, 이미 조립된 상태로.
연동마다 정체성과 연속성을 다시 만들지 않고 제품 경험에 집중하세요.
실제 캐릭터 정의
비공개·공개 캐릭터의 목소리, 행동, 예시와 제작자 설정을 그대로 사용합니다.
지속적인 대화 기록
서버가 정식 채팅을 보관하므로 보통 최신 메시지만 보내면 됩니다.
장기 기억
지원 모델이 기억을 저장하고 요약이 긴 이야기 흐름을 유지합니다.
시나리오 기반 라우팅
한 캐릭터의 여러 시작 상황을 선택 가능한 항목으로 제공합니다.
모든 화면에서 같은 대화
앱, reverie.im, 봇과 API 사이에서 대화를 이어갑니다.
모델·크레딧 처리 내장
설정, 토큰 조절, 한도와 크레딧은 Reverie와 같은 규칙을 따릅니다.
빠른 시작
키에서 캐릭터까지 세 단계로.
첫 요청에 새 SDK나 별도 대화 DB가 필요 없습니다.
- 01
범위 지정 API 키 생성
연동 이름과 선택적 기본 캐릭터를 정하고 rk_ 키를 한 번 복사해 서버에 보관합니다.
- 02
기본 URL 변경
https://reverie.im/api/device/v1 을 사용하고 model에 캐릭터나 시나리오를 전달합니다.
- 03
사용자 메시지 전송
응답을 즉시 스트리밍하고 Reverie가 다음 호출을 위해 대화를 보관합니다.
AI 캐릭터 API FAQ
규격은 익숙합니다. 상태는 일반적이지 않습니다.
호환성, 라우팅, 지속성과 실제 API 제한.
기억하는 캐릭터로 개발
연속성이 필요한 앱을 위한 API
캐릭터 제품에는 정체성, 시나리오, 기록, 기억과 화자 선택이 필요합니다. Reverie가 이를 하나의 호환 엔드포인트에 담습니다.
프롬프트 대신 캐릭터 사용
각 앱을 재배포하지 않고 Reverie에서 정의를 개선합니다.
긴 대화 비용 관리
요약과 토큰 예산으로 끝없는 기록 재전송 없이 상태를 유지합니다.
제품 사이를 이동
사용자 UI에서 시작한 대화도 Reverie 웹에 남습니다.
유용한 부분은 OpenAI 호환
익숙한 요청·응답 형식을 유지하면서 model은 캐릭터나 시나리오를 지정합니다.
공식 SDK
OpenAI JavaScript/Python 클라이언트와 사용자 지정 URL 도구를 사용합니다.
유효한 캐릭터 찾기
models 엔드포인트가 최근 캐릭터 또는 기본 캐릭터의 시나리오를 반환합니다.
예측 가능한 오류
인증, 캐릭터 없음, 한도와 할당량 오류를 기계 판독 코드로 제공합니다.