RU ▾
Получить API-ключ

API-ключ Character AI: как получить и использовать

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

Светящийся ключ над панелями чата, подключенными к серверному кубу, иллюстрирующий доступ к API-ключу

Ключевые моменты

  1. Вы получаете ключ после регистрации через Google или по электронной почте и паролю, а затем открыв страницу API-ключа.
  2. Новые пользователи могут получить $0,50 пробного баланса в один клик, без привязки карты, срок действия — 7 дней.
  3. Используйте базовый URL https://api.characteraiapi.com/v1 и идентификатор модели uncensored с любым SDK OpenAI.
  4. Храните ключ на сервере или в переменной окружения, никогда не помещайте его в публичный код фронтенда.

Что вы получаете на самом деле

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, работа по созданию персонажа лежит на вашей стороне. Вы пишете системное сообщение с описанием личности, сохраняете историю разговора и отправляете её с каждым запросом. Это дает вам контроль над голосом, памятью и темпом, который закрытый продукт редко предоставляет. Жесткое ограничение одинаково для всех пользователей: никогда не будет контента сексуального характера с участием несовершеннолетних.

Получите свой ключ за пять шагов

Весь путь занимает несколько минут. Для начала не нужна карта.

  1. Зарегистрируйтесь. Используйте Google или зарегистрируйтесь по электронной почте и паролю.
  2. Откройте страницу ключа. Перейдите на страницу API-ключа, где отображается ключ вашей учетной записи.
  3. Получите пробный баланс. Один клик на этой странице добавляет $0,50 пробного кредита. Предложение ограничено одним на человека и действует 7 дней.
  4. Скопируйте ключ. Сразу сохраните его в менеджере паролей или в файле секретов.
  5. Отправьте тестовый запрос. Используйте приведенную ниже команду 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, а что нет, статья мифы и факты охватывает распространённые заблуждения.

Вопросы и ответы

Получу ли я API-ключ Character.ai?

Нет. Это отдельный независимый сервис. Вы получаете ключ для эндпоинта, совместимого с OpenAI, с идентификатором модели uncensored, который можно использовать как бэкенд для ваших приложений с персонажами.

Нужна ли карта для получения ключа?

Нет. Вы регистрируетесь через Google или по электронной почте и паролю, затем получаете $0,50 пробного кредита одним кликом на странице API-ключа. Пробный баланс действителен в течение 7 дней.

Могу ли я использовать ключ в SillyTavern или других интерфейсах чата?

Инструменты, принимающие пользовательский эндпоинт, совместимый с OpenAI, могут его использовать. Введите базовый URL, ваш ключ и имя модели uncensored.

Что происходит при достижении лимита запросов?

API возвращает HTTP 429 с кодом rate_limited или concurrency. Подождите немного и повторите запрос. Пробный ключ позволяет выполнять 2 параллельных запроса и 60 запросов в минуту.

Сгорает ли кредит?

Купленный кредит не сгорает. Только $0,50 пробного кредита имеют срок действия 7 дней.

Ваш ключ — всего в одной форме

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.

Получить API-ключ