
Что такое API нейросети
API — это способ, которым ваша программа обращается к модели: отправляет вопрос и получает ответ. Чат в браузере удобен человеку, а API нужен, когда ответ модели должен появиться внутри вашей системы — в карточке клиента, в мобильном приложении, в обработке входящих писем или документов.
Для доступа выдаётся API-ключ. По нему сервис понимает, кто делает запрос и с какого баланса списывать оплату.
Зачем один ключ для разных моделей
Модели разных разработчиков сильны в разном, и часто хочется сравнить несколько, прежде чем выбрать. Если подключаться к каждому разработчику напрямую, у каждого свой аккаунт, свой ключ, свой баланс и свой формат запроса.
В RICHAT всё это собрано в одном месте:
- 300+ моделей каталога — Claude, GPT, DeepSeek, YandexGPT и другие, от 50+ разработчиков;
- один ключ — модель выбирается в самом запросе;
- один баланс — тот же, что у ассистентов на сайте, в Telegram и MAX;
- один формат — API совместим с OpenAI API.
Это не мешает при необходимости работать с разработчиками моделей напрямую — но для многих задач удобнее один ключ и один счёт.
Совместимость с OpenAI API
Формат OpenAI API стал общим языком для работы с языковыми моделями: под него написаны библиотеки, примеры и готовые программы. API RICHAT совместим с ним. Подключайтесь любой библиотекой для OpenAI: поменяйте адрес и ключ, а остальной код оставьте прежним.
В поле model укажите любую модель каталога. Не указали — ответит модель вашего ассистента, по умолчанию YandexGPT с обработкой данных в России.
Шаг 1. Получите API-ключ
- Зарегистрируйтесь в кабинете RICHAT по email, без карты. API включается после первого пополнения баланса: приветственный бонус 1 000 ₽ работает в тест-чате, окне чата на сайте, Telegram и MAX.
- Откройте раздел «API» и создайте доступ: назовите ассистента — API работает от его имени. Инструкция и база знаний — по желанию.
- Скопируйте ключ. Он показывается один раз, поэтому сразу сохраните его в надёжном месте.
Ключ привязан к именному ассистенту. Если ключ попал не в те руки — перевыпустите его, и старый сразу перестанет работать.
Шаг 2. Отправьте первый запрос
Условный пример на Python с библиотекой openai. Точный адрес API и готовые примеры на Python, cURL и Node.js с вашим ключом — в разделе «API» кабинета.
from openai import OpenAI
client = OpenAI(
base_url="<адрес API из кабинета>",
api_key="<ваш ключ>",
)
response = client.chat.completions.create(
model="<модель из каталога>", # можно не указывать — ответит модель ассистента
messages=[
{"role": "system", "content": "Ты помощник отдела продаж. Отвечай кратко."},
{"role": "user", "content": "Сформулируй ответ клиенту на вопрос о сроках доставки."},
],
)
print(response.choices[0].message.content)
Хотите сравнить модели — поменяйте значение model и отправьте тот же запрос. Ключ, баланс и код остаются прежними.
Не храните ключ прямо в коде, который попадает в общий репозиторий: удобнее передавать его через переменные окружения.
Что можно делать через API
- Диалог — обычные вопросы и ответы с историей переписки.
- Картинки и файлы — фото, сканы, PDF.
- Ответ по мере генерации — текст появляется частями, как в чате.
- Вызов ваших функций — модель сама решает, когда обратиться к функции вашей системы, например найти заказ.
- Ответ в JSON — когда результат нужно сразу разобрать программой.
Всё это работает для моделей, которые это умеют: возможности разных моделей отличаются, проверяйте их в каталоге.
База знаний — по желанию
Без документов модель отвечает по вашей инструкции — свою инструкцию можно передать прямо в запросе. Если нужны ответы по документам компании, загрузите их ассистенту: PDF, Word, PowerPoint, Excel, ссылку на сайт или каталог товаров. Тогда ответы через API будут опираться на найденное в базе знаний.
Если программировать не нужно, тот же ассистент подключается без кода — к окну чата на сайте, к Telegram и MAX. Как это сделать в Telegram, читайте в статье «Как сделать чат-бота в Telegram с ИИ», а про ответы клиентам с передачей оператору — в статье «Чат-бот поддержки с ИИ».
Лимиты и оплата
- 300 запросов в минуту на аккаунт. Нужно больше — напишите, поднимем.
- Оплата по токенам выбранной модели — от 1,13 ₽ за 1 млн токенов, без абонентской платы.
- Общий баланс аккаунта — для API и для ассистентов во всех каналах.
- Ошибка 402 — если баланс закончился. Пополните его, и запросы снова пойдут.
Подробнее — на странице «API RICHAT».


