Açık API

Reverie, OpenAI uyumlu bir Chat Completions uç noktası sunar. Herhangi bir OpenAI istemcisini buraya yöneltin, bir Reverie API anahtarı geçirin ve model alanında bir LLM yerine bir karakter ya da senaryo adı verin. Konuşmayı, anıları ve özetleri Reverie kendi tarafında tuttuğu için her isteğin taşıması gereken tek şey yeni mesajınızdır.

Oturum açmış her hesap kullanabilir. Abonelik kademesi de bekleme listesi de yok — bir API anahtarı gerekir, hepsi bu. Bir tane oluşturun →

Temel URL ve kimlik doğrulama

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

Ayarlar → Daha fazla → API Anahtarları, API Endpoint kartında tam temel URL'yi kopyalama düğmesiyle birlikte gösterir.

Hızlı başlangıç

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

Ayarlar → Daha fazla → API Anahtarları ayrıca bir istek oluşturucu içerir; gerçek anahtarlarınızdan biriyle ve gerçek bir karakterle bu üç parçayı üretir.

model alanı bir karakteri adlandırır

Kısa bir ID'nin çözülüp çözülmeyeceğini belirleyen ayrıntılar:

• [...] dizginin sonunda olmalıdır.
• 8 karakter ya da daha kısa bir sonek, yalnızca hâlihazırda sohbetiniz olan karakterlerle karşılaştırılır; web'de olsun, API üzerinden olsun. Hiç açmadığınız bir karakterin kısa ID'si sessizce boşa düşer.
• Senaryo araması yalnızca anahtar bir karaktere sabitlenmişken çalışır. Genel bir anahtarla kısa senaryo ID'si asla çözülemez.
• 8 karakterden uzunu tam ID sayılır.

Kimlerle konuşabileceğinizi listelemek

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

Genel bir anahtar son karakterlerinizi döndürür. Bir karaktere sabitlenmiş anahtar ise o karakterin senaryolarını, hiç senaryosu yoksa karakterin kendisini döndürür. Her kayıt şöyle görünür:

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

id değerini doğrudan model alanına kopyalayın. Bu uç noktanın hataları OpenAI zarfı yerine yalın bir hata biçimi kullanır.

İstek gövdesinden neler okunur

Dört alan okunur. Geri kalan her şey kabul edilip sessizce atılır.

Uyarı vermeden yok sayılanlar: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

messages nasıl işlenir:

• system mesajları atılır. Kişilik ve davranış, istekten değil, karakterin kendi alanlarından gelir. Prompt alanları →
• Görüntü desteği yoktur. İçerik bir dizgi ya da parçalardan oluşan bir dizi olabilir, ama yalnızca text parçaları okunur; görsel parçalar yok sayılır.
• Konuşmaya yalnızca son user mesajı eklenir. Daha önceki kullanıcı mesajları yok sayılır.
• Asistan mesajları yalnızca geçmişi eşitlemek için kullanılır (aşağıya bakın).
• Boş ya da yalnızca boşluktan oluşan son kullanıcı mesajı missing_user_message döndürür.

Yanıtlar

Akışsız yanıt, sıradan bir chat.completion nesnesidir. finish_reason her zaman stop'tur — içerideki araç çağrıları dışarıya hiç yansımaz — ve usage sayaçları sıfırdır; bu yüzden tokenları yanıttan değil, API anahtarları sayfasındaki kullanım istatistiklerinden ölçün.

Akışlı yanıt bir text/event-stream'dir:

1. İçerik parçaları: delta.content taşıyan chat.completion.chunk nesneleri. Baştaki delta: {"role": "assistant"} parçası gönderilmez.
2. finish_reason değeri stop, length ya da content_filter olan bir bitiş parçası. Araç çağrısıyla gelen bitişler stop olarak bildirilir.
3. choices dizisi boş olan bir kullanım parçası.
4. data: [DONE].

Üretim akışın ortasında başarısız olursa akış data: {"error": {...}} yayar, ardından [DONE] gelir.

Konuşmanın durumu

Konuşmayı Reverie saklar. Her anahtar-karakter çifti için tek bir sohbet vardır, web uygulamasında diğer sohbetlerinizin yanında görünür ve her tur şunlardan kurulur: karakterin sistem promptu ve senaryosu, world book kanonu, uzun vadeli anılar, biriken özetler, karakterin anlatım tarzı, yanıt uzunluğu ve NSFW ayarları, hesap dilinizden gelen bir dil kilidi ve modelin bağlam penceresine sığdığı kadar yakın geçmiş. Model araçları destekliyorsa bellek araçları da çalışır.

Geçmişi sunucu tuttuğu için onu yeniden göndermenize gerek yok.

Hangi LLM yanıtlar

Buna istek değil karakter karar verir — siz bir LLM adı vermedikçe. Öncelik, en düşükten en yükseğe: varsayılan sohbet modeli, sonra karakterin kendi model ayarı, sonra model olarak geçirilen Reverie model ID'si ve en sonunda web uygulamasında o sohbet için belirlediğiniz model tercihi; bu sonuncusu hepsini geçer. Modeller →

Hatalar

/chat/completions hataları OpenAI zarfını kullanır: {"error": {"message", "type", "param": null, "code"}}.

İki durum bu zarfın dışında kalır: GET /models hataları ve doğrulamanın reddettiği istek gövdeleri (örneğin aralık dışı bir temperature) — ikisi de yalın bir hata biçimi döndürür.

Hız sınırları ve kotalar

Bu API'de anahtar başına hız sınırı, eşzamanlılık tavanı ve istek kotası yoktur. Kullanımınızı yalnızca iki şey sınırlar:

Ücretsiz model penceresi web sohbeti, hikâyeler, romanlar ve botlarla ortaktır — her yüzey için ayrı değil, hesap başına tek bir haktır. Ücretsiz modeller →

Reverie dışarıya webhook göndermez; üretimin bittiğini öğrenmek için abone olunacak bir şey yoktur.

Karakter içe aktarma

İkinci bir uç nokta olan POST /api/v1/characters/import, bir karakter kartından karakter oluşturur. İçe aktarma kapsamı olan bir anahtar ister ve bu, ayarlar sayfasının oluşturduğu türden bir anahtar değildir. API anahtarları → ve Karakter içe aktarma →

İlgili

• API anahtarları — anahtar oluşturma, sabitleme, süre verme ve izleme
• Modeller — model ID'leri ve kredi çarpanları
• Sınırlar — üründeki diğer tavanlar
• Krediler — isteklerin fiyatlandırılması