PL ▾
Pobierz klucz API

Klucz API Character AI: Jak go uzyskać i użyć

Jeśli szukałeś klucza API Character AI, pierwszą rzeczą, którą musisz wiedzieć, jest to, że ta strona nie jest Character.ai i nie wydaje jego kluczy. Daje Ci klucz do niezależnego API tekstowego kompatybilnego z OpenAI, które działa jako backend dla aplikacji czatu z postaciami.

Świecący klucz nad panelami czatu połączonymi z sześcianem serwera, ilustrujący dostęp do klucza API

Kluczowe punkty

  1. Otrzymujesz klucz po zalogowaniu się przez Google lub e-mail i hasło, a następnie otwarciu strony klucza API.
  2. Nowi użytkownicy mogą odebrać $0,50 kredytu próbnego jednym kliknięciem, bez karty, ważny przez 7 dni.
  3. Użyj base URL https://api.characteraiapi.com/v1 i identyfikatora modelu uncensored z dowolnym SDK OpenAI.
  4. Przechowuj klucz na serwerze lub w zmiennej środowiskowej, nigdy w publicznie dostępnym kodzie front-end.

Co właściwie otrzymujesz

Character.ai to produkt czatu konsumenckiego. Osoby szukające klucza API Character AI zwykle chcą jednego z dwóch: sposobu na wywołanie czatu z postacią z własnego kodu lub backendu dla aplikacji persony, która nie jest ograniczona przez zasady produktu hostowanego. Ta strona pokrywa drugą potrzebę. Rejestrujesz się, otrzymujesz klucz i wysyłasz zapytania do endpointu kompatybilnego z OpenAI. Nic tutaj nie łączy się z Character.ai ani nie wykorzystuje jego postaci.

Usługa to hostowane API tekstowe przed jednym modelem o otwartych wagach, prowadzone przez niezależnego dostawcę i dostrojone do odpowiadania bez odmów treści dla prawnego użytku dorosłego. Nie jest to oficjalne API żadnego dostawcy modeli ani router między dostawcami. Identyfikator modelu to uncensored, a base URL to https://api.characteraiapi.com/v1. Istnieją dwie metody: POST /v1/chat/completions i GET /v1/models.

Ponieważ interfejs jest zgodny z OpenAI, praca nad postacią spoczywa po Twojej stronie. Piszesz osobowość jako wiadomość systemową, zachowujesz historię rozmowy i wysyłasz ją z każdym zapytaniem. To daje Ci kontrolę nad głosem, pamięcią i tempem, której zamknięte produkty rzadko udostępniają. Twardy limit jest taki sam dla każdego użytkownika: brak treści seksualnych z udziałem nieletnich, nigdy.

Uzyskaj swój klucz w pięciu krokach

Cała ścieżka zajmuje kilka minut. Nie potrzebujesz karty, aby zacząć.

  1. Zarejestruj się. Użyj Google lub zarejestruj się e-mailem i hasłem.
  2. Otwórz stronę klucza. Przejdź do strony klucza API, gdzie widoczny jest klucz Twojego konta.
  3. Odbierz kredyt próbny. Jedno kliknięcie na tej stronie dodaje $0,50 kredytu próbnego. Ograniczony do jednego na osobę i ważne przez 7 dni.
  4. Skopiuj klucz. Przechowuj go w menedżerze haseł lub pliku sekretów od razu.
  5. Wyślij testowe zapytanie. Użyj poniższego polecenia curl przed wprowadzeniem jakichkolwiek zmian w kodzie aplikacji.

Traktuj klucz jak hasło. Każdy, kto go ma, może wydać Twoje saldo. Jeśli myślisz, że wyciekł, przestań go używać natychmiast, usuń go z każdej aplikacji i sprawdź swoje saldo pod kątem nieoczekiwanych wydatków.

Przetestuj klucz za pomocą curl

Ustaw klucz jako zmienną środowiskową, aby nigdy nie trafił do historii powłoki jako zwykły tekst w skrypcie. Następnie wypisz modele. To potwierdza, że klucz działa i że docierasz do właściwego hosta.

export API_KEY="paste-your-key-here"

curl https://api.characteraiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Powinieneś otrzymać listę JSON, która zawiera uncensored. Teraz wyślij pierwsze zapytanie czatu z małą personą. Wiadomość systemowa ustawia postać, wiadomość użytkownika zaczyna scenę.

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

Odpowiedź ma standardowy kształt ukończeń czatu. Tekst odpowiedzi jest w choices[0].message.content. Nagłówki odpowiedzi zawierają również X-Request-Id, X-Balance-USD i nagłówki limitu zapytań, co jest przydatne, gdy chcesz wyświetlić pozostałe saldo w swoim własnym UI.

Użyj klucza z Pythona lub Node.js

Dowolne SDK OpenAI działa po zmianie dwóch wartości: base URL i klucza. Oto wersja Python z oficjalnym pakietem openai.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.characteraiapi.com/v1",
    api_key=os.environ["API_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

I to samo wywołanie w Node:

import OpenAI from "openai";

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

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

Wiele interfejsów czatu ma pole dla niestandardowego endpointu kompatybilnego z OpenAI. W tych narzędziach wklejasz base URL, wklejasz klucz i wpisujesz uncensored jako nazwę modelu. Nic innego nie musi się zmienić. Strona dokumentacji wymienia obsługiwane parametry, w tym strumieniowanie, wywoływanie funkcji i tryb JSON.

Powszechne problemy z kluczem i szybkie rozwiązania

Większość pierwszych niepowodzeń wynika z kilku małych błędów. Sprawdź je w tej kolejności, zanim podejrzysz coś większego.

  • Białe znaki lub cudzysłowy w kluczu. Znak nowej linii na końcu skopiowany z pliku wystarczy, aby uwierzytelnienie się nie powiodło. Wypisz długość zmiennej i porównaj ją z tym, co skopiowałeś.
  • Zły base URL. Base URL kończy się na /v1, a SDK dołącza /chat/completions samo. Jeśli dodasz również /chat/completions do base URL, ścieżka się podwaja i zapytanie zawodzi.
  • Zła nazwa modelu. Identyfikator modelu to uncensored. Nazwy wypożyczone z innych usług nie będą pasować. Wywołaj GET /v1/models, aby zobaczyć, co zgłasza serwer.
  • Brakujący nagłówek. Surowe wywołania HTTP potrzebują Authorization: Bearer po którym następuje spacja i klucz, plus Content-Type: application/json w zapytaniach POST.
  • Puste saldo. Nagłówek odpowiedzi X-Balance-USD pokazuje, co zostało. Gdy kredyt próbny zostanie zużyty lub minie 7 dni, doładuj konto, w przeciwnym razie zapytania przestaną się udawać.
  • Limity zapytań. Klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę. Dwa otwarte strumienie zajmują już oba sloty.

Zły klucz zazwyczaj produkuje błąd uwierzytelnienia zamiast odpowiedzi modelu. Limit produkuje HTTP 429 z kodem rate_limited lub concurrency. Czytanie ciała błędu, a nie tylko kodu statusu, oszczędza czas, ponieważ kod mówi Ci, jaki limit osiągnąłeś. Każda odpowiedź zawiera X-Request-Id; przechowuj go w swoich logach, aby dopasować nieudane wywołanie do konkretnego zapytania później.

Limity wersji próbnej i co daje kredyt próbny

Klucz próbny ma niższe limity niż pełny: 2 równoległe zapytania i 60 zapytań na minutę. Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę. Do testowania jednej persony to wystarczy. Jeśli uruchamiasz wiele czatów jednocześnie z testowego skryptu, zobaczysz HTTP 429 z kodem błędu concurrency lub rate_limited. Żądanie strumieniowania trzyma swój slot concurrency do końca strumienia, więc dwa otwarte strumienie na kluczu próbnym go wypełniają.

Jak daleko starcza $0,50? Ceny to $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Weź typową turę czatu z 1 500 tokenami historii i persony idącymi i 300 tokenami wychodzącymi:

  • Wejście: 1 500 tokenów x $0,15 / 1 000 000 = $0,000225
  • Wyjście: 300 tokenów x $0,50 / 1 000 000 = $0,00015
  • Jedna tura: $0,000375
  • $0,50 / $0,000375 to około 1 333 tur

To wystarczy do przetestowania kilku postaci poprawnie. Nieudane lub odrzucone zapytania nie są rozliczane, więc zapytanie, które kończy się błędem, nie zużywa Twojego kredytu. Kredyt próbny wygasa po 7 dniach; kredyt, który kupisz później, nie wygasa.

Ustawienia, które sprawiają, że persona brzmi wiarygodnie

Klucz zapewnia połączenie; jakość postaci wynika z promptu i ustawień próbkowania. Kilka dobrych nawyków pomaga bardziej niż sprytne triki.

Napisz wiadomość systemową jako krótką kartę postaci w prostych zdaniach: kim jest postać, jak mówi, czego chce i jak długie powinny być jej odpowiedzi. Podaj jedną lub dwie przykładowe linie dialogowe, jeśli głos ma znaczenie. Modele lepiej podążają za konkretnymi przykładami niż przymiotnikami, więc linia "Mara odpowiada krótkimi, suchymi zdaniami i żartuje, gdy się denerwuje" działa lepiej niż "Mara jest bystra i urocza".

Użyj temperature, aby ustawić żywotność. Wartości bliskie 0,9 dają bardziej zróżnicowane sformułowania, podczas gdy wartości bliskie 0,5 utrzymują postać w większej stabilności. Dodaj sekwencję stop, jeśli Twoja aplikacja używa etykiety mówiącego, takiej jak "Użytkownik:", i chcesz zapobiec pisaniu przez model drugiej strony rozmowy. Kary za częstotliwość i obecność mogą zmniejszyć powtarzanie się fraz w długich rozmowach, ale zwiększaj je ostrożnie, ponieważ wysokie wartości mogą sprawić, że dialog będzie nienaturalny.

Pamiętaj, że model wie tylko to, co znajduje się w zapytaniu. Jeśli postać ma pamiętać imię gracza z 200 wiadomości temu, albo utrzymuj tę wiadomość w oknie kontekstu, albo przechowuj kluczowe fakty w wiadomości systemowej. Dlatego lista pamięci aktualizowana przez Ciebie często sprawdza się lepiej niż wysyłanie ogromnej historii.

Doładowywanie konta po wyczerpaniu kredytu próbnego

Nie ma subskrypcji. Płacisz z góry i zużywasz środki na tokeny. Doładowania przyjmują dowolną kwotę całkowitą od $20 do $500, a większe kwoty dają bonus: +5% od $50, +10% od $100 i +15% od $200. Zatem $50 to $52,50 kredytu, $100 to $110, a $200 to $230. Możesz zapłacić kryptowalutami (USDT w sieci TRC20, USDC na Base).

Pełna tabela znajduje się na stronie z cenami. Do planowania: tura z 1500 tokenami wejściowymi i 300 wyjściowymi kosztuje $0,000375, więc $20 wystarczą na około 53 000 takich tur. Długotrwała gra fabularna kosztuje więcej na turę, ponieważ historia rośnie, dlatego ograniczaj ilość historii, którą wysyłasz ponownie. Okno kontekstu wynosi 100 000 tokenów (prompt plus uzupełnienie), ale rzadko chcesz je wypełnić.

Bezpieczne przechowywanie klucza w prawdziwej aplikacji

Najczęstszym błędem w projekcie czatu jest bezpośrednie wywoływanie API z kodu przeglądarki. Wszystko dostarczone do przeglądarki może być odczytane przez każdego odwiedzającego, w tym klucz. Umieść mały serwer między frontendem a API. Przeglądarka komunikuje się z Twoim endpointem, Twój endpoint dodaje nagłówek Authorization: Bearer i przekazuje zapytanie.

  • Przechowuj klucz w zmiennej środowiskowej lub menedżerie sekretów, a nie w repozytorium.
  • Dodaj wpis .env do .gitignore przed pierwszym zatwierdzeniem zmian.
  • Używaj jednego klucza na środowisko, aby wyciek w środowisku deweloperskim nie wpłynął na produkcję.
  • Obserwuj nagłówek X-Balance-USD, aby wychwycić niekontrolowane pętle na wczesnym etapie.
  • Ponów próbę przy HTTP 429 po krótkim oczekiwaniu. Tymczasowa odpowiedź o przeładowaniu zawiera Retry-After: 5.

Prompty wysłane do API nie są używane do trenowania. Mimo to unikaj wysyłania danych, których nie chciałbyś przechowywać w logach po swojej stronie. Jeśli chcesz dokładniej przyjrzeć się temu, co takie API robi, a czego nie, artykuł mity i fakty omawia powszechne nieporozumienia.

Pytania i odpowiedzi

Czy to daje mi klucz API Character.ai?

Nie. To osobny, niezależny serwis. Otrzymujesz klucz do endpointu kompatybilnego z OpenAI z identyfikatorem modelu uncensored, którego możesz użyć jako backendu dla własnych aplikacji z postaciami.

Czy potrzebuję karty, aby uzyskać klucz?

Nie. Rejestrujesz się za pomocą Google lub e-maila i hasła, a następnie jednym kliknięciem na stronie klucza API odbierasz $0,50 kredytu próbnego. Kredyt próbny jest ważny przez 7 dni.

Czy mogę użyć klucza w SillyTavern lub innych interfejsach czatu?

Narzędzia akceptujące niestandardowy endpoint kompatybilny z OpenAI mogą go użyć. Wprowadź base URL, swój klucz i nazwę modelu uncensored.

Co się stanie, gdy przekroczę limit zapytań?

API zwraca HTTP 429 z kodem rate_limited lub concurrency. Poczekaj chwilę i spróbuj ponownie. Klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę.

Czy kredyt wygasa?

Kupiony kredyt nigdy nie wygasa. Tylko $0,50 kredytu próbnego ma 7-dniowy okres ważności.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień base URL. To cała konfiguracja.

Pobierz klucz API