Open API

Reverie는 OpenAI 호환 Chat Completions 엔드포인트를 제공합니다. 어떤 OpenAI 클라이언트든 여기로 향하게 하고, Reverie API 키를 넘기고, model 필드에는 LLM 대신 캐릭터나 시나리오를 적으세요. 대화와 기억과 요약은 Reverie 쪽에 남으므로, 요청마다 필요한 것은 새 메시지 하나뿐입니다.

로그인한 계정이면 누구나 쓸 수 있습니다. 구독 등급도 대기자 명단도 없습니다 — 필요한 건 API 키뿐입니다. 만들러 가기 →

기본 URL과 인증

https://www.reverie.im/api/device/v1
Authorization: Bearer rk_...

설정 → 더보기 → API 키의 API Endpoint 카드에 정확한 기본 URL이 복사 버튼과 함께 나옵니다.

빠른 시작

curl --no-buffer https://www.reverie.im/api/device/v1/chat/completions \
  -H "Authorization: Bearer $REVERIE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "Luna [abc12345]",
  "messages": [
    {
      "role": "user",
      "content": "Hi"
    }
  ],
  "stream": true,
  "temperature": 0.8
}'

설정 → 더보기 → API 키에는 당신의 실제 키 하나와 실제 캐릭터로 위 세 가지 코드를 만들어 주는 요청 빌더도 있습니다.

model 필드는 캐릭터를 가리킵니다

짧은 ID가 풀리는지를 결정하는 세부 사항:

• [...]는 문자열 끝에 있어야 합니다.
• 여덟 글자 이하의 접미사는 웹에서든 API에서든 이미 대화한 적 있는 캐릭터하고만 맞춰 봅니다. 한 번도 열어본 적 없는 캐릭터의 짧은 ID는 조용히 빗나갑니다.
• 시나리오 조회는 키가 캐릭터에 고정되어 있을 때만 돕니다. 전역 키로는 짧은 시나리오 ID가 결코 풀리지 않습니다.
• 여덟 글자를 넘으면 전체 ID로 취급됩니다.

무엇과 이야기할 수 있는지 보기

curl https://www.reverie.im/api/device/v1/models \
  -H "Authorization: Bearer $REVERIE_API_KEY"

전역 키는 최근 캐릭터를 돌려줍니다. 캐릭터에 고정된 키는 그 캐릭터의 시나리오를, 시나리오가 없으면 캐릭터 자체를 돌려줍니다. 각 항목은 이렇게 생겼습니다.

{
	"id": "Luna [abc12345]",
	"object": "model",
	"created": 1759200000,
	"owned_by": "character",
	"permission": [],
	"root": "<full character id>",
	"parent": null
}

id를 그대로 model에 복사하세요. 이 엔드포인트의 오류는 OpenAI 껍데기가 아니라 단순한 오류 형태를 씁니다.

요청 본문에서 읽는 것

읽는 필드는 넷뿐입니다. 나머지는 받아들인 뒤 조용히 버려집니다.

경고 없이 무시되는 것: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

messages를 다루는 방식:

• system 메시지는 버려집니다. 인격과 행동은 요청이 아니라 캐릭터 자신의 필드에서 나옵니다. 프롬프트 필드 →
• 비전은 지원하지 않습니다. 내용은 문자열이어도 조각 배열이어도 되지만 text 조각만 읽히고, 이미지 조각은 무시됩니다.
• 대화에 더해지는 것은 마지막 user 메시지뿐입니다. 그 앞의 사용자 메시지는 무시됩니다.
• 어시스턴트 메시지는 아래의 기록 동기화에만 쓰입니다.
• 마지막 사용자 메시지가 비었거나 공백뿐이면 missing_user_message가 돌아옵니다.

응답

스트리밍이 아닌 응답은 평범한 chat.completion 객체입니다. finish_reason은 언제나 stop이고 — 내부 도구 호출은 절대 드러나지 않습니다 — usage 수치는 전부 0이므로, 토큰은 응답이 아니라 API 키 페이지의 사용 통계에서 재세요.

스트리밍 응답은 text/event-stream입니다.

1. 내용 청크: delta.content를 담은 chat.completion.chunk 객체. 맨 앞의 delta: {"role": "assistant"} 청크는 보내지 않습니다.
2. 종료 청크. finish_reason은 stop, length, content_filter 중 하나입니다. 도구 호출로 끝난 경우도 stop으로 보고됩니다.
3. choices가 빈 배열인 사용량 청크.
4. data: [DONE].

생성이 중간에 실패하면 스트림은 data: {"error": {...}}를 내보낸 뒤 [DONE]을 보냅니다.

대화 상태

대화는 Reverie가 보관합니다. 키와 캐릭터의 짝마다 대화 하나가 존재하고, 웹 앱에서도 다른 대화들과 나란히 보입니다. 매 턴은 캐릭터의 시스템 프롬프트와 시나리오, 월드북의 설정, 장기 기억, 갱신되는 요약, 캐릭터의 서술 방식과 응답 길이와 NSFW 설정, 계정 언어에서 온 언어 고정, 그리고 모델의 컨텍스트 창이 허용하는 만큼의 최근 기록으로 짜입니다. 모델이 도구를 지원하면 기억 도구도 함께 돕니다.

기록은 서버가 들고 있으니 다시 보낼 필요가 없습니다.

어떤 LLM이 답하는가

요청이 아니라 캐릭터가 정합니다 — 당신이 LLM을 직접 지목한 경우만 빼고요. 우선순위는 낮은 쪽부터 기본 대화 모델, 그다음 캐릭터 자신의 모델 설정, 그다음 model로 넘긴 Reverie 모델 ID, 마지막으로 웹 앱에서 그 대화에 지정한 모델 선호이며, 이것이 전부를 이깁니다. 모델 →

오류

/chat/completions의 오류는 OpenAI 껍데기를 씁니다. {"error": {"message", "type", "param": null, "code"}}.

이 껍데기에 들어가지 않는 경우가 둘 있습니다. GET /models의 오류, 그리고 검증에서 걸러진 요청 본문(예를 들어 범위를 벗어난 temperature) — 둘 다 단순한 오류 형태를 돌려줍니다.

요청 제한과 할당량

이 API에는 키별 요청 제한도, 동시 실행 상한도, 요청 할당량도 없습니다. 당신의 사용량을 묶는 것은 두 가지입니다.

무료 모델 창은 웹 채팅, 스토리, 소설, 봇과 함께 씁니다 — 창구마다 따로가 아니라 계정당 하나의 몫입니다. 무료 모델 →

Reverie는 바깥으로 웹훅을 보내지 않습니다. 생성 완료를 받아 볼 구독 대상이 없습니다.

캐릭터 가져오기

두 번째 엔드포인트 POST /api/v1/characters/import는 캐릭터 카드로 캐릭터를 만듭니다. 가져오기 권한이 있는 키가 필요하고, 그것은 설정 페이지가 만들어 주는 종류의 키가 아닙니다. API 키 → 및 캐릭터 가져오기 →

관련 문서

• API 키 — 키를 만들고, 고정하고, 만료시키고, 사용량을 봅니다
• 모델 — 모델 ID와 크레딧 배수
• 제한 — 제품 안의 다른 상한들
• 크레딧 — 요청 가격이 매겨지는 방식