API Character AI: Zmień klienta w trzech krokach

Wymagania wstępne

Przed napisaniem kodu potrzebujesz aktywnego konta na characteraiapi.com. Odwiedź stronę Pobierz klucz API i zarejestruj się, podając tylko adres e-mail i hasło. Nie jest wymagana karta kredytowa, a nowe konta otrzymują $0,50 w kredycie próbnym ważnym przez 7 dni. Po rejestracji Twój klucz API jest wyświetlany natychmiast. Przechowuj klucz bezpiecznie, ponieważ uwierzytelnia on wszystkie zapytania do endpointu. Będziesz również potrzebować zainstalowanego w środowisku programistycznym obsługiwanego interfejsu SDK. Endpoint character ai api przyjmuje standardowe parametry OpenAI, więc dowolny klient kompatybilny z OpenAI zadziała po niewielkich zmianach.

Zainstaluj SDK

W projektach Python zainstaluj oficjalny pakiet OpenAI za pomocą pip. Biblioteka ta automatycznie obsługuje serializację JSON i żądania HTTP. W aplikacjach Node.js użyj npm, aby dodać pakiet openai. Obie biblioteki obsługują strumieniowanie i wywoływanie funkcji opisane dalej w tym przewodniku. Upewnij się, że wersja Twojego SDK jest wystarczająco nowa, aby obsługiwać Server-Sent Events (SSE) dla strumieniowania tokenów w czasie rzeczywistym. Jeśli używasz własnego klienta HTTP zamiast SDK, musisz ręcznie obsłużyć ładunek JSON i parsowanie strumienia SSE zgodnie ze specyfikacją API OpenAI.

Uwierzytelnianie

Każde zapytanie do API musi zawierać Twój klucz API w nagłówku Authorization. Użyj formatu Bearer YOUR_API_KEY. Podstawowy URL dla wszystkich zapytań to https://api.characteraiapi.com/v1. Podczas korzystania z SDK ustaw konfigurację base_url na tę wartość i podaj klucz za pomocą parametru api_key. Jeśli zgubisz klucz lub podejrzysz jego wyciek, możesz go wygenerować ponownie z panelu; stary klucz zostanie natychmiast unieważniony. Na jedno konto przysługuje tylko jeden aktywny klucz. Upewnij się, że używasz właściwego podstawowego URL, ponieważ zapytania do standardowego endpointu OpenAI zakończą się błędem 404 lub 401.

Podstawowe uzupełnianie czatu

Podstawowa funkcjonalność jest obsługiwana przez endpoint /v1/chat/completions. Wyślij żądanie POST z nazwą modelu uncensored i historią wiadomości. Model zwraca tekst bez stosowania standardowych filtrów treści dla legalnych treści dla dorosłych. Poniżej znajduje się przykład curl demonstrujący proste żądanie uzupełniania tekstu.

Copycurl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

To zapytanie zwraca obiekt uzupełnienia zawierający wygenerowany tekst. Możesz dostosować parametry, takie jak temperature, aby kontrolować losowość, lub max_tokens, aby ograniczyć długość wyjścia. Model obsługuje okno kontekstu 100 000 tokenów, co pozwala przetwarzać znaczną historię rozmowy lub długie dokumenty w jednym zapytaniu.

Odpowiedzi strumieniowe

Aby zapewnić lepsze wrażenia użytkownika, włącz strumieniowanie, ustawiając stream: true w swoim zapytaniu. API zwraca zdarzenia wysyłane przez serwer (SSE) zawierające fragmenty tokenów, które są generowane. Zmniejsza to postrzegane opóźnienie w aplikacjach chatbotów. Użyj parametru stream_options, jeśli chcesz otrzymać końcowe statystyki zużycia w ostatnim zdarzeniu. Strumieniowanie jest szczególnie przydatne w przypadku odgrywania ról postaci w czasie rzeczywistym, gdzie wyświetlanie tekstu słowo po słowie zwiększa immersję. Upewnij się, że Twój kod klienta poprawnie obsługuje format SSE, aby analizować każdy fragment sekwencyjnie.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Limity zapytań i błędy

API narzuca limit 300 zapytań na minutę na klucz. Jeśli go przekroczysz, otrzymasz błąd 429 Too Many Requests. Ciała zapytań są ograniczone do 8 MB. Powszechne błędy obejmują 401 za nieprawidłowy lub brakujący klucz oraz 402, jeśli Twój przedpłacony kredyt został wyczerpany. Możesz doładować konto od kwoty $10 za pomocą kryptowalut (USDT lub USDC), z bonusowymi kredytami dostępnymi przy większych wpłatach. W przeciwieństwie do niektórych dostawców, nie ma ukrytych opłat ani blokad subskrypcyjnych; płacisz tylko za zużyte tokeny. Ceny są przejrzyste: $0.25 za 1M tokenów wejściowych i $1.00 za 1M tokenów wyjściowych. Upewnij się, że Twoja logika obsługi błędów ponawia zapytania po otrzymaniu 429 z wykładniczym opóźnieniem.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.characteraiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.characteraiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);