API-ключ Character AI: как получить и использовать
Если вы искали API-ключ для Character AI, первое, что нужно знать: этот сайт не является Character.ai и не выдает их ключи. Он предоставляет вам ключ для независимого текстового API, совместимого с OpenAI, который работает как готовая замена бэкенда для приложений с чатами персонажей.
Обновлено

Ключевые моменты
- Вы получаете ключ после регистрации через Google или по электронной почте и паролю, а затем открыв страницу API-ключа.
- Новые пользователи могут получить $0,50 пробного баланса в один клик, без привязки карты, срок действия — 7 дней.
- Используйте базовый URL https://api.characteraiapi.com/v1 и идентификатор модели
uncensoredс любым SDK OpenAI. - Храните ключ на сервере или в переменной окружения, никогда не помещайте его в публичный код фронтенда.
Что вы получаете на самом деле
Character.ai — это потребительский чат-продукт. Те, кто ищет API-ключ для Character AI, обычно хотят одного из двух: способ вызывать чат-бота с персонажем из собственного кода или бэкенд для приложения с персонажами, не ограниченный правилами хостингового продукта. Этот сайт закрывает вторую потребность. Вы регистрируетесь, получаете ключ и отправляете запросы к эндпоинту, совместимому с OpenAI. Здесь нет связи с Character.ai и не используются их персонажи.
Сервис представляет собой хостинговое текстовое API перед одной моделью с открытыми весами, запущенное независимым провайдером и настроенное на ответы без отказов по контенту для законного использования взрослыми. Это не официальный API какого-либо вендора моделей и не роутер между вендорами. Идентификатор модели — uncensored, а базовый URL — https://api.characteraiapi.com/v1. Существуют два метода: POST /v1/chat/completions и GET /v1/models.
Поскольку интерфейс соответствует OpenAI, работа по созданию персонажа лежит на вашей стороне. Вы пишете системное сообщение с описанием личности, сохраняете историю разговора и отправляете её с каждым запросом. Это дает вам контроль над голосом, памятью и темпом, который закрытый продукт редко предоставляет. Жесткое ограничение одинаково для всех пользователей: никогда не будет контента сексуального характера с участием несовершеннолетних.
Получите свой ключ за пять шагов
Весь путь занимает несколько минут. Для начала не нужна карта.
- Зарегистрируйтесь. Используйте Google или зарегистрируйтесь по электронной почте и паролю.
- Откройте страницу ключа. Перейдите на страницу API-ключа, где отображается ключ вашей учетной записи.
- Получите пробный баланс. Один клик на этой странице добавляет $0,50 пробного кредита. Предложение ограничено одним на человека и действует 7 дней.
- Скопируйте ключ. Сразу сохраните его в менеджере паролей или в файле секретов.
- Отправьте тестовый запрос. Используйте приведенную ниже команду curl перед тем, как касаться кода приложения.
Относитесь к ключу как к паролю. Любой, у кого он есть, может потратить ваш баланс. Если вы считаете, что ключ утек, немедленно прекратите его использование, удалите из всех приложений и проверьте баланс на предмет неожиданных расходов.
Протестируйте ключ с помощью curl
Установите ключ в качестве переменной окружения, чтобы он никогда не попадал в историю оболочки в виде обычного текста внутри скрипта. Затем выведите список моделей. Это подтвердит, что ключ работает и вы обращаетесь к правильному хосту.
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Вы должны получить список в формате JSON, включающий uncensored. Теперь отправьте первый запрос на чат с небольшим описанием личности. Системное сообщение задает персонажа, сообщение пользователя начинает сцену.
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
}'Ответ имеет стандартную структуру chat completions. Текст ответа находится в choices[0].message.content. Заголовки ответа также содержат X-Request-Id, X-Balance-USD и заголовки лимита запросов, что удобно, когда вы хотите показать оставшийся баланс в своём интерфейсе.
Используйте ключ из Python или Node
Любой SDK OpenAI работает, если изменить два значения: базовый URL и ключ. Вот версия для Python с официальным пакетом 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)И тот же вызов в 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);Многие чат-интерфейсы имеют поле для пользовательского эндпоинта, совместимого с OpenAI. В этих инструментах вы вставляете базовый URL, вставляете ключ и вводите uncensored как имя модели. Ничего больше менять не нужно. На странице документации перечислены поддерживаемые параметры, включая потоковую передачу, вызов функций и JSON-режим.
Распространенные проблемы с ключом и быстрые решения
Большинство сбоев при первом использовании вызваны несколькими небольшими ошибками. Проверьте их в этом порядке, прежде чем подозревать что-то более серьезное.
- Лишние пробелы или кавычки в ключе. Символ новой строки, скопированный из файла, достаточно, чтобы аутентификация не удалась. Выведите длину переменной и сравните её с тем, что вы скопировали.
- Неверный базовый URL. Базовый URL заканчивается на
/v1, а SDK сам добавляет/chat/completions. Если вы также добавите/chat/completionsк базовому URL, путь удвоится, и запрос не выполнится. - Неверное имя модели. Идентификатор модели —
uncensored. Имена, заимствованные из других сервисов, не совпадут. ВызовитеGET /v1/models, чтобы увидеть, что сообщает сервер. - Отсутствующий заголовок. Для прямых HTTP-вызовов нужны
Authorization: Bearer, за которым следует пробел и ключ, а такжеContent-Type: application/jsonдля запросов POST. - Пустой баланс. Заголовок ответа
X-Balance-USDпоказывает остаток. Когда пробный баланс исчерпан или истек его 7-дневный срок, пополните баланс, иначе запросы перестанут выполняться. - Лимиты запросов. Пробный ключ позволяет выполнять 2 параллельных запроса и 60 в минуту. Два открытых потока уже занимают оба слота.
Неверный ключ обычно вызывает ошибку аутентификации, а не ответ модели. Превышение лимита вызывает HTTP 429 с кодом rate_limited или concurrency. Чтение тела ошибки, а не только кода статуса, экономит время, потому что код указывает, какой лимит вы исчерпали. Каждый ответ содержит X-Request-Id; сохраняйте его в логах, чтобы позже сопоставить неудачный вызов с конкретным запросом.
Лимиты пробного периода и что он дает
Пробный ключ имеет более низкие лимиты, чем полный: 2 параллельных запроса и 60 запросов в минуту. Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Для тестирования одной персоны этого более чем достаточно. Если вы запускаете несколько чатов одновременно из тестового скрипта, вы увидите HTTP 429 с кодом ошибки concurrency или rate_limited. Потоковый запрос удерживает слот параллельности до конца потока, поэтому два открытых потока на пробном ключе заполняют его.
На сколько хватает $0,50? Цены составляют $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Возьмем типичный ход чата с 1500 токенами истории и личности на входе и 300 токенов на выходе:
- Вход: 1500 токенов x $0,15 / 1 000 000 = $0,000225
- Выход: 300 токенов x $0,50 / 1 000 000 = $0,00015
- Один ход: $0,000375
- $0,50 / $0,000375 составляет около 1333 ходов
Этого достаточно, чтобы протестировать несколько персонажей. Неудачные или отклоненные запросы не оплачиваются, поэтому запрос с ошибкой не тратит ваш баланс. Пробный период истекает через 7 дней; купленный позже баланс не сгорает.
Настройки, которые делают персонажа убедительным
Ключ обеспечивает подключение; качество персонажа зависит от промпта и настроек сэмплирования. Несколько привычек помогают больше, чем хитрые трюки.
Пишите системное сообщение в виде краткого описания персонажа простыми предложениями: кто он, как говорит, чего хочет и насколько длинными должны быть его ответы. Приведите одну-две реплики, если важен стиль речи. Модели лучше следуют конкретным примерам, чем прилагательным, поэтому фраза «Мара отвечает короткими сухими предложениями и шутит, когда нервничает» работает лучше, чем «Мара остроумна и обаятельна».
Используйте temperature для настройки живости. Значения около 0,9 дают более разнообразную формулировку, а значения около 0,5 делают поведение персонажа более стабильным. Добавьте последовательность stop, если в вашем приложении используется метка говорящего (например, «Пользователь:») и вы хотите предотвратить генерацию реплики собеседника моделью. Штрафы за частоту и присутствие могут уменьшить повторение фраз в длинных диалогах, но повышайте их осторожно, так как высокие значения могут сделать диалог странным.
Помните, что модель знает только то, что есть в запросе. Если персонаж должен вспомнить имя игрока из 200 сообщений назад, либо оставьте это сообщение в контекстном окне, либо сохраните ключевые факты в системном сообщении. Именно поэтому список памяти, который вы обновляете самостоятельно, часто оказывается лучше, чем отправка огромной истории переписки.
Пополнение после окончания пробного периода
Подписки нет. Вы вносите предоплаченный баланс и тратите его на токены. Пополнение принимает любую целую сумму от $20 до $500, а большие суммы дают бонус: +5% от $50, +10% от $100 и +15% от $200. Таким образом, $50 превращаются в $52,50 кредита, $100 — в $110, а $200 — в $230. Вы можете оплатить криптовалютой (USDT в сети TRC20, USDC в сети Base).
Полная таблица цен доступна на странице с ценами. Для планирования: запрос на 1 500 входящих и 300 исходящих токенов стоит $0,000375, поэтому $20 покрывают примерно 53 000 таких ходов. Долгие ролевые игры обходятся дороже за ход из-за роста истории, поэтому ограничьте объём данных, которые вы отправляете повторно. Контекстное окно составляет 100 000 токенов (промпт плюс завершение), но редко возникает желание заполнить его полностью.
Безопасное хранение ключа в реальном приложении
Самая распространённая ошибка в чат-проектах — вызов API напрямую из кода браузера. Всё, что попадает в браузер, может быть прочитано любым посетителем, включая ключ. Разместите небольшой сервер между вашим интерфейсом и API. Браузер обращается к вашему маршруту, маршрут добавляет заголовок Authorization: Bearer и пересылает запрос.
- Храните ключ в переменной окружения или в менеджере секретов, а не в репозитории.
- Добавьте запись
.envв.gitignoreперед первым коммитом. - Используйте один ключ для каждой среды, чтобы утечка в разработке не затронула продакшн.
- Следите за заголовком
X-Balance-USD, чтобы рано обнаруживать бесконечные циклы. - Повторяйте запрос при HTTP 429 с небольшой задержкой. Ответ о временной перегрузке включает заголовок
Retry-After: 5.
Промпты, отправленные в API, не используются для обучения. Тем не менее, избегайте отправки данных, которые вы не хотели бы хранить в логах на своей стороне. Если вы хотите глубже разобраться в том, что делает такое API, а что нет, статья мифы и факты охватывает распространённые заблуждения.