Open API

Reverie mở một endpoint Chat Completions tương thích với OpenAI. Trỏ bất kỳ client OpenAI nào vào đó, gửi kèm một khóa API Reverie, và dùng trường model để nêu tên một nhân vật hoặc kịch bản thay vì một LLM. Reverie giữ cuộc trò chuyện, ký ức và các bản tóm tắt ở phía nó, nên mỗi yêu cầu chỉ cần mang theo tin nhắn mới của bạn.

Bất kỳ tài khoản nào đã đăng nhập đều dùng được. Không có hạng đăng ký, không có danh sách chờ — bạn cần một khóa API, thế thôi. Tạo một khóa →

URL gốc và xác thựcCopy Anchor Link

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

Cài đặt → Thêm → API Keys hiện đúng URL gốc trong thẻ API Endpoint, kèm một nút sao chép.

Bắt đầu nhanhCopy Anchor Link

curl --no-buffer https://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
}'

Cài đặt → Thêm → API Keys còn có một bộ dựng yêu cầu, sinh ra đúng ba đoạn mã này từ một khóa thật của bạn và một nhân vật thật.

Trường model nêu tên một nhân vậtCopy Anchor Link

Những chi tiết quyết định một ID ngắn có tra ra được hay không:

• [...] phải nằm ở cuối chuỗi.
• Hậu tố dài 8 ký tự trở xuống chỉ được đối chiếu với những nhân vật bạn đã có cuộc trò chuyện, trên web hay qua API. ID ngắn của một nhân vật bạn chưa từng mở sẽ trượt đi trong im lặng.
• Việc tra kịch bản chỉ chạy khi khóa được ghim vào một nhân vật. Với khóa toàn cục, một ID kịch bản ngắn không bao giờ tra ra được.
• Dài hơn 8 ký tự thì được coi là ID đầy đủ.

Liệt kê những ai bạn có thể trò chuyệnCopy Anchor Link

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

Khóa toàn cục trả về các nhân vật gần đây của bạn. Khóa ghim vào một nhân vật thì trả về các kịch bản của nhân vật ấy, hoặc chính nhân vật nếu nó không có kịch bản nào. Mỗi mục trông như thế này:

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

Chép thẳng id vào model. Lỗi từ endpoint này dùng một dạng lỗi đơn giản chứ không phải lớp vỏ của OpenAI.

Phần thân yêu cầu đọc những gìCopy Anchor Link

Có bốn trường được đọc. Mọi thứ khác đều được nhận rồi lặng lẽ bỏ đi.

Bị bỏ qua mà không báo: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

messages được xử lý ra sao:

• Tin nhắn system bị bỏ. Tính cách và cách hành xử đến từ chính các trường của nhân vật, không phải từ yêu cầu. Các trường prompt →
• Không hỗ trợ hình ảnh. Nội dung có thể là chuỗi hoặc mảng các phần, nhưng chỉ phần text được đọc; phần ảnh bị bỏ qua.
• Chỉ tin nhắn user cuối cùng được thêm vào cuộc trò chuyện. Các tin nhắn người dùng trước đó bị bỏ qua.
• Tin nhắn của trợ lý chỉ dùng để đồng bộ lịch sử (xem bên dưới).
• Tin nhắn người dùng cuối cùng mà rỗng hoặc chỉ có khoảng trắng sẽ nhận về missing_user_message.

Phản hồiCopy Anchor Link

Phản hồi không theo luồng là một đối tượng chat.completion bình thường. finish_reason luôn là stop — các lệnh gọi công cụ bên trong không bao giờ lộ ra — và các bộ đếm usage đều bằng không, nên hãy đo token bằng thống kê sử dụng ở trang khóa API chứ đừng đo từ phản hồi.

Phản hồi theo luồng là text/event-stream:

1. Các khối nội dung: đối tượng chat.completion.chunk có delta.content. Không có khối mở đầu delta: {"role": "assistant"} nào được gửi.
2. Một khối kết thúc, với finish_reason là stop, length hoặc content_filter. Kết thúc do gọi công cụ cũng được báo là stop.
3. Một khối sử dụng với mảng choices rỗng.
4. data: [DONE].

Nếu việc sinh nội dung hỏng giữa chừng, luồng phát ra data: {"error": {...}} rồi tới [DONE].

Trạng thái cuộc trò chuyệnCopy Anchor Link

Reverie lưu cuộc trò chuyện. Mỗi cặp khóa–nhân vật có đúng một cuộc trò chuyện, nó hiện trong ứng dụng web bên cạnh các cuộc trò chuyện khác của bạn, và mỗi lượt được dựng từ prompt hệ thống và kịch bản của nhân vật, phần chính truyện trong sách thế giới, ký ức dài hạn, các bản tóm tắt cuộn dần, lối kể của nhân vật, độ dài câu trả lời và thiết lập NSFW, một khóa ngôn ngữ lấy từ ngôn ngữ tài khoản của bạn, cùng với lượng lịch sử gần đây nhiều nhất mà cửa sổ ngữ cảnh của mô hình chứa nổi. Các công cụ ký ức chạy khi mô hình hỗ trợ công cụ.

Vì máy chủ giữ lịch sử, bạn không cần gửi lại nó.

LLM nào trả lờiCopy Anchor Link

Nhân vật quyết định, chứ không phải yêu cầu — trừ khi bạn tự nêu tên một LLM. Thứ tự ưu tiên từ thấp lên cao: mô hình trò chuyện mặc định, rồi thiết lập mô hình của chính nhân vật, rồi ID mô hình Reverie truyền trong model, và cuối cùng là lựa chọn mô hình bạn đặt riêng cho cuộc trò chuyện đó trong ứng dụng web, thứ thắng tất cả. Mô hình →

LỗiCopy Anchor Link

Lỗi từ /chat/completions dùng lớp vỏ của OpenAI: {"error": {"message", "type", "param": null, "code"}}.

Hai trường hợp nằm ngoài lớp vỏ đó: lỗi của GET /models, và phần thân yêu cầu bị khâu kiểm tra từ chối (chẳng hạn temperature ngoài khoảng) — cả hai đều trả về dạng lỗi đơn giản.

Giới hạn tần suất và hạn mứcCopy Anchor Link

API này không có giới hạn tần suất theo khóa, không có trần số yêu cầu đồng thời, và không có hạn mức yêu cầu. Chỉ hai thứ ràng buộc mức dùng của bạn:

Cửa sổ mô hình miễn phí dùng chung với trò chuyện trên web, truyện, tiểu thuyết và các bot — đó là một phần chung cho cả tài khoản, không phải mỗi nơi một phần. Mô hình miễn phí →

Reverie không gửi webhook ra ngoài; không có gì để đăng ký nhận sự kiện sinh xong.

Nhập nhân vậtCopy Anchor Link

Còn một endpoint thứ hai, POST /api/v1/characters/import, tạo nhân vật từ một thẻ nhân vật. Nó cần khóa có phạm vi nhập, mà đó không phải loại khóa trang cài đặt tạo ra. API Keys → và Nhập nhân vật →

Liên quanCopy Anchor Link

• API Keys — tạo, ghim, đặt hạn và theo dõi khóa
• Mô hình — ID mô hình và hệ số nhân tín dụng
• Giới hạn — những trần khác trong sản phẩm
• Tín dụng — yêu cầu được tính giá thế nào