Open API

Reverie menyediakan endpoint Chat Completions yang kompatibel dengan OpenAI. Arahkan klien OpenAI mana pun ke sana, kirim kunci API Reverie, dan gunakan kolom model untuk menyebut sebuah karakter atau skenario, bukan sebuah LLM. Percakapan, memori, dan ringkasannya disimpan Reverie di sisinya, jadi tiap permintaan cukup membawa pesan barumu saja.

Akun mana pun yang sudah masuk bisa memakainya. Tidak ada tingkat langganan dan tidak ada daftar tunggu — kamu butuh sebuah kunci API, itu saja. Buat satu →

URL dasar dan autentikasiCopy Anchor Link

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

Pengaturan → Lainnya → Kunci API menampilkan URL dasar yang tepat pada kartu API Endpoint, lengkap dengan tombol salin.

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

Pengaturan → Lainnya → Kunci API juga punya perakit permintaan yang membuat ketiga cuplikan ini memakai salah satu kunci aslimu dan karakter sungguhan.

Kolom model menyebut sebuah karakterCopy Anchor Link

Hal-hal yang menentukan apakah ID pendek bisa dikenali:

• [...] harus berada di akhir teks.
• Akhiran sepanjang 8 karakter atau kurang hanya dicocokkan dengan karakter yang sudah punya obrolan denganmu, di web maupun lewat API. ID pendek milik karakter yang belum pernah kamu buka akan meleset diam-diam.
• Pencarian skenario hanya berjalan kalau kuncinya disematkan pada sebuah karakter. Dengan kunci global, ID skenario yang pendek tidak akan pernah dikenali.
• Lebih dari 8 karakter diperlakukan sebagai ID lengkap.

Melihat dengan siapa kamu bisa bicaraCopy Anchor Link

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

Kunci global mengembalikan karakter-karaktermu yang terbaru. Kunci yang disematkan pada sebuah karakter malah mengembalikan skenario karakter itu, atau karakternya sendiri kalau ia tak punya skenario. Tiap entri terlihat begini:

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

Salin id langsung ke model. Kesalahan dari endpoint ini memakai bentuk kesalahan sederhana, bukan bungkus OpenAI.

Apa yang dibaca dari isi permintaanCopy Anchor Link

Empat kolom yang dibaca. Selebihnya diterima lalu dibuang diam-diam.

Diabaikan tanpa peringatan: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

Bagaimana messages diperlakukan:

• Pesan system dibuang. Kepribadian dan perilaku datang dari kolom-kolom karakternya sendiri, bukan dari permintaan. Kolom prompt →
• Tidak ada dukungan penglihatan. Isinya boleh berupa string atau larik bagian, tetapi hanya bagian text yang dibaca; bagian gambar diabaikan.
• Yang ditambahkan ke percakapan hanya pesan user terakhir. Pesan pengguna sebelumnya diabaikan.
• Pesan asisten hanya dipakai untuk menyelaraskan riwayat (lihat di bawah).
• Pesan pengguna terakhir yang kosong atau hanya berisi spasi akan mengembalikan missing_user_message.

ResponsCopy Anchor Link

Respons tanpa streaming adalah objek chat.completion biasa. finish_reason selalu stop — panggilan perkakas internal tidak pernah ditampakkan — dan penghitung usage semuanya nol, jadi ukurlah token dari statistik pemakaian di halaman kunci API, bukan dari responsnya.

Respons streaming berupa text/event-stream:

1. Potongan isi: objek chat.completion.chunk dengan delta.content. Tidak ada potongan pembuka delta: {"role": "assistant"} yang dikirim.
2. Potongan penutup, dengan finish_reason berupa stop, length, atau content_filter. Penutupan karena panggilan perkakas dilaporkan sebagai stop.
3. Potongan pemakaian dengan larik choices yang kosong.
4. data: [DONE].

Kalau pembuatan gagal di tengah aliran, aliran itu mengeluarkan data: {"error": {...}} lalu [DONE].

Keadaan percakapanCopy Anchor Link

Reverie menyimpan percakapannya. Ada satu obrolan untuk tiap pasangan kunci dan karakter, obrolan itu muncul di aplikasi web bersama obrolanmu yang lain, dan tiap giliran disusun dari prompt sistem serta skenario karakternya, kanon buku dunia, memori jangka panjang, ringkasan yang terus diperbarui, gaya penceritaan karakter, panjang balasan dan setelan NSFW, kunci bahasa dari bahasa akunmu, dan sebanyak mungkin riwayat terbaru yang muat di jendela konteks modelnya. Perkakas memori berjalan bila modelnya mendukung perkakas.

Karena riwayatnya dipegang server, kamu tidak perlu mengirimnya ulang.

LLM mana yang menjawabCopy Anchor Link

Karakternya yang memutuskan, bukan permintaanmu — kecuali kamu menyebut sebuah LLM. Urutan dari yang terlemah ke terkuat: model obrolan bawaan, lalu setelan model milik karakternya, lalu ID model Reverie yang dikirim sebagai model, dan terakhir preferensi model yang kamu tetapkan untuk obrolan itu di aplikasi web, yang mengalahkan semuanya. Model →

KesalahanCopy Anchor Link

Kesalahan dari /chat/completions memakai bungkus OpenAI: {"error": {"message", "type", "param": null, "code"}}.

Dua hal berada di luar bungkus itu: kesalahan GET /models, dan isi permintaan yang ditolak oleh pemeriksaan (misalnya temperature di luar rentang) — keduanya mengembalikan bentuk kesalahan sederhana.

Batas laju dan kuotaCopy Anchor Link

API ini tidak punya batas laju per kunci, tidak punya batas permintaan serentak, dan tidak punya kuota permintaan. Hanya dua hal yang membatasi pemakaianmu:

Jendela model gratis dipakai bersama dengan obrolan web, cerita, novel, dan para bot — ia satu jatah per akun, bukan satu jatah untuk tiap tempat. Model gratis →

Reverie tidak mengirim webhook ke luar; tidak ada yang bisa dilanggani untuk memantau selesainya pembuatan.

Mengimpor karakterCopy Anchor Link

Ada endpoint kedua, POST /api/v1/characters/import, yang membuat karakter dari sebuah kartu karakter. Ia butuh kunci dengan cakupan impor, dan itu bukan jenis kunci yang dibuat halaman pengaturan. Kunci API → dan Mengimpor karakter →

TerkaitCopy Anchor Link

• Kunci API — membuat, menyematkan, memberi masa berlaku, dan memantau kunci
• Model — ID model dan pengali kredit
• Batasan — batas-batas lain di produk ini
• Kredit — bagaimana permintaan dihargai