Open API

Reverie एक OpenAI-संगत Chat Completions एंडपॉइंट देता है। किसी भी OpenAI क्लाइंट को उस पर मोड़िए, एक Reverie API की भेजिए, और model फ़ील्ड में LLM की जगह कोई किरदार या परिदृश्य लिखिए। बातचीत, यादें और सारांश Reverie अपनी तरफ़ रखता है, इसलिए हर अनुरोध में बस आपका नया संदेश चाहिए।

साइन इन किया कोई भी खाता इसे इस्तेमाल कर सकता है। न कोई सदस्यता स्तर है, न प्रतीक्षा सूची — आपको एक API की चाहिए, बस इतना ही। एक बनाएँ →

बेस URL और प्रमाणीकरण

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

सेटिंग्स → और देखें → API कीज़ में API Endpoint कार्ड पर सही बेस URL दिखता है, साथ में कॉपी बटन भी।

जल्दी शुरू करें

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 कीज़ पेज के उपयोग आँकड़ों से नापिए।

स्ट्रीमिंग वाला जवाब 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 बाहर कोई webhook नहीं भेजता; बनना पूरा होने की सूचना के लिए सदस्यता लेने को कुछ है ही नहीं।

किरदार आयात करना

एक दूसरा एंडपॉइंट, POST /api/v1/characters/import, किरदार कार्ड से किरदार बनाता है। इसके लिए आयात के दायरे वाली की चाहिए, और वह उस तरह की की नहीं है जो सेटिंग्स पेज बनाता है। API कीज़ → और किरदार आयात करना →

संबंधित

• API कीज़ — कीज़ बनाना, जोड़ना, अवधि तय करना और उन पर नज़र रखना
• मॉडल — मॉडल ID और क्रेडिट गुणक
• सीमाएँ — उत्पाद की बाकी हदें
• क्रेडिट — अनुरोधों की क़ीमत कैसे बनती है