開放 API

Reverie 提供一個與 OpenAI 相容的 Chat Completions 端點。把任何 OpenAI 用戶端指向它，帶上一組 Reverie API 金鑰，再用 model 欄位指定角色或場景，而不是某個大型語言模型。對話、記憶和摘要都由 Reverie 在它那一端保存，所以每次請求只需要附上你的新訊息。

任何已登入的帳號都能使用。不需要任何訂閱方案，也沒有候補名單——你只需要一組 API 金鑰，就這樣。建立金鑰 →

基礎網址與驗證

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

設定 → 更多 → API 金鑰中的 API 端點卡片會顯示確切的基礎網址，旁邊還有複製按鈕。

快速開始

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
}'

設定 → 更多 → API 金鑰也有一個請求產生器，會用你真實的某組金鑰和某個真實的角色，產生上面這三段程式碼。

model 欄位指定的是角色

決定簡短 ID 能否解析的細節：

• [...] 必須位於字串的結尾。
• 長度在 8 個字元以內的後綴，只會比對你已經聊過天的角色，無論是在網頁上還是透過 API。你從未開啟過的角色，其簡短 ID 會在沒有任何提示的情況下比對失敗。
• 只有在金鑰綁定了角色時，才會查找場景。使用全域金鑰時，簡短的場景 ID 永遠無法解析。
• 超過 8 個字元會被視為完整 ID。

列出你可以對話的對象

curl https://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 計數全都是零，所以請從 API 金鑰頁面上的使用統計來計算 Token，而不是從回應中取得。

串流回應的格式是 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 設定、依你帳號語系而定的語言鎖定，以及模型上下文視窗所能容納的近期紀錄。當模型支援工具時，記憶工具就會執行。

由於紀錄保存在伺服器端，你不需要重新傳送整段紀錄。

由哪個大型語言模型回答

由角色決定，而不是由請求決定——除非你指定了某個大型語言模型。優先順序由低到高為：預設聊天模型，接著是角色本身的模型設定，然後是作為 model 傳入的 Reverie 模型 ID，最後是你在網頁應用程式中為該聊天設定的模型偏好，它的優先順序高於前面所有設定。模型 →

錯誤

/chat/completions 的錯誤使用 OpenAI 的錯誤外層結構：{"error": {"message", "type", "param": null, "code"}}。

有兩種情況不使用這個外層結構：GET /models 的錯誤，以及未通過驗證而被拒絕的請求內容（例如超出範圍的 temperature）——這兩者都會回傳簡單的錯誤格式。

速率限制與配額

這個 API 沒有每組金鑰的速率限制、沒有並行上限，也沒有請求配額。限制你用量的只有兩件事：

免費模型的時段額度與網頁聊天、故事、小說和機器人共用——每個帳號只有一份額度，而不是每個使用管道各一份。免費模型 →

Reverie 不會對外傳送 webhook；沒有可以訂閱的生成完成事件。

匯入角色

第二個端點 POST /api/v1/characters/import 可以從角色卡建立角色。它需要一組具備匯入權限範圍的金鑰，而設定頁面建立的金鑰並不是這種。API 金鑰 →與匯入角色 →

相關內容

• API 金鑰——建立、綁定、設定到期並監控金鑰
• 模型——模型 ID 和點數倍率
• 限制——產品中的其他上限
• 點數——請求如何計價