Otwarte API

Reverie udostępnia punkt końcowy Chat Completions zgodny z OpenAI. Skieruj na niego dowolnego klienta OpenAI, przekaż klucz API Reverie i w polu model podaj postać albo scenariusz zamiast modelu językowego. Rozmowę, wspomnienia i streszczenia Reverie trzyma po swojej stronie, więc każde żądanie potrzebuje tylko twojej nowej wiadomości.

Może z niego korzystać każde zalogowane konto. Nie ma progu subskrypcji ani listy oczekujących — potrzebujesz klucza API i tyle. Utwórz klucz →

Adres bazowy i uwierzytelnianie

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

Ustawienia → Więcej → Klucze API pokazują dokładny adres bazowy na karcie API Endpoint, razem z przyciskiem kopiowania.

Szybki start

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

Ustawienia → Więcej → Klucze API mają też kreator żądań, który generuje te trzy fragmenty na podstawie jednego z twoich prawdziwych kluczy i prawdziwej postaci.

Pole model wskazuje postać

Szczegóły, które decydują, czy krótkie ID się rozwiąże:

• [...] musi być na końcu tekstu.
• Końcówkę o długości 8 znaków lub mniej porównuje się wyłącznie z postaciami, z którymi masz już rozmowę — w sieci albo przez API. Krótkie ID postaci, której nigdy nie otworzyłeś, przepada po cichu.
• Wyszukiwanie scenariusza uruchamia się tylko wtedy, gdy klucz jest przypięty do postaci. Przy kluczu globalnym krótkie ID scenariusza nigdy się nie rozwiąże.
• Więcej niż 8 znaków traktuje się jak pełne ID.

Sprawdzanie, z kim możesz rozmawiać

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

Klucz globalny zwraca twoje ostatnie postacie. Klucz przypięty do postaci zwraca zamiast tego scenariusze tej postaci, a jeśli żadnego nie ma — samą postać. Każdy wpis wygląda tak:

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

Skopiuj id prosto do model. Błędy tego punktu końcowego mają prostą postać, a nie kopertę OpenAI.

Co jest czytane z treści żądania

Czytane są cztery pola. Cała reszta jest przyjmowana i po cichu odrzucana.

Ignorowane bez ostrzeżenia: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

Jak traktowane jest messages:

• Wiadomości system są odrzucane. Osobowość i zachowanie biorą się z własnych pól postaci, a nie z żądania. Pola promptu →
• Nie ma obsługi obrazu. Treść może być tekstem albo tablicą części, ale czytane są tylko części text; części obrazkowe są ignorowane.
• Do rozmowy dopisywana jest tylko ostatnia wiadomość user. Wcześniejsze wiadomości użytkownika są ignorowane.
• Wiadomości asystenta służą wyłącznie do synchronizacji historii (niżej).
• Pusta lub złożona z samych spacji ostatnia wiadomość użytkownika zwraca missing_user_message.

Odpowiedzi

Odpowiedź bez strumieniowania to zwykły obiekt chat.completion. finish_reason zawsze wynosi stop — wewnętrzne wywołania narzędzi nigdy nie są pokazywane — a liczniki usage są wyzerowane, więc tokeny mierz statystykami użycia na stronie kluczy API, a nie z odpowiedzi.

Odpowiedź strumieniowa to text/event-stream:

1. Fragmenty treści: obiekty chat.completion.chunk z delta.content. Początkowy fragment delta: {"role": "assistant"} nie jest wysyłany.
2. Fragment kończący, z finish_reason równym stop, length albo content_filter. Zakończenia wywołane przez narzędzie raportowane są jako stop.
3. Fragment użycia z pustą tablicą choices.
4. data: [DONE].

Jeśli generowanie padnie w połowie strumienia, strumień wysyła data: {"error": {...}}, a potem [DONE].

Stan rozmowy

Rozmowę przechowuje Reverie. Na każdą parę klucz-postać przypada jedna rozmowa, widać ją w aplikacji webowej obok twoich pozostałych rozmów, a każda tura budowana jest z promptu systemowego i scenariusza postaci, kanonu z ksiąg świata, wspomnień długoterminowych, narastających streszczeń, stylu narracji postaci, długości odpowiedzi i ustawień NSFW, blokady języka wziętej z języka twojego konta oraz tylu ostatnich wiadomości, ile zmieści okno kontekstu modelu. Narzędzia pamięci działają, gdy model obsługuje narzędzia.

Skoro historię trzyma serwer, nie musisz jej odtwarzać.

Który model odpowiada

Decyduje postać, a nie żądanie — chyba że sam wskażesz model językowy. Kolejność od najsłabszej do najmocniejszej: domyślny model czatu, potem własne ustawienie modelu w postaci, potem ID modelu Reverie przekazane jako model, a na końcu preferencja modelu ustawiona dla tej rozmowy w aplikacji webowej, która bije wszystkie pozostałe. Modele →

Błędy

Błędy z /chat/completions używają koperty OpenAI: {"error": {"message", "type", "param": null, "code"}}.

Dwa przypadki wypadają poza tę kopertę: błędy GET /models oraz treści żądań odrzucone przy walidacji (na przykład temperature spoza zakresu) — oba zwracają prostą postać błędu.

Limity zapytań i przydziały

To API nie ma limitu zapytań na klucz, pułapu równoczesności ani przydziału żądań. Twoje użycie ograniczają tylko dwie rzeczy:

Okno darmowych modeli dzielisz z czatem w sieci, historiami, powieściami i botami — to jeden przydział na konto, a nie jeden na każde miejsce. Darmowe modele →

Reverie nie wysyła webhooków na zewnątrz; nie ma się do czego zapisać, żeby dostać powiadomienie o zakończeniu generowania.

Importowanie postaci

Drugi punkt końcowy, POST /api/v1/characters/import, tworzy postać z karty postaci. Wymaga klucza z zakresem importu, a to nie jest ten rodzaj klucza, który tworzy strona ustawień. Klucze API → i Import postaci →

Powiązane

• Klucze API — tworzenie, przypinanie, wygasanie i podgląd kluczy
• Modele — ID modeli i mnożniki kredytów
• Limity — pozostałe pułapy w produkcie
• Kredyty — jak wyceniane są żądania