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.
Zaktualizowano

Kluczowe punkty
- Otrzymujesz klucz po zalogowaniu się przez Google lub e-mail i hasło, a następnie otwarciu strony klucza API.
- Nowi użytkownicy mogą odebrać $0,50 kredytu próbnego jednym kliknięciem, bez karty, ważny przez 7 dni.
- Użyj base URL https://api.characteraiapi.com/v1 i identyfikatora modelu
uncensoredz dowolnym SDK OpenAI. - 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ąć.
- Zarejestruj się. Użyj Google lub zarejestruj się e-mailem i hasłem.
- Otwórz stronę klucza. Przejdź do strony klucza API, gdzie widoczny jest klucz Twojego konta.
- 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.
- Skopiuj klucz. Przechowuj go w menedżerze haseł lub pliku sekretów od razu.
- 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/completionssamo. Jeśli dodasz również/chat/completionsdo 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łajGET /v1/models, aby zobaczyć, co zgłasza serwer. - Brakujący nagłówek. Surowe wywołania HTTP potrzebują
Authorization: Bearerpo którym następuje spacja i klucz, plusContent-Type: application/jsonw zapytaniach POST. - Puste saldo. Nagłówek odpowiedzi
X-Balance-USDpokazuje, 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
.envdo.gitignoreprzed 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.