API для чатов и чат-ботов

Готовый чат или API для своего чат-бота

Если вы хотите просто задать вопрос модели, откройте чат CLODEX после входа. Если вы разрабатываете интерфейс для клиентов, нужен API: ваш сервер принимает сообщение, проверяет пользователя и отправляет запрос к выбранной модели. Ответ затем возвращается в ваш сайт, приложение или Telegram.

API чат-бота не заменяет бизнес-логику. Хранение диалогов, доступ к базе знаний, согласие на обработку данных и правила вызова инструментов остаются задачей вашего приложения. Не публикуйте основной ключ в коде виджета, который загружается в браузер.

Открыть готовый чат · Получить и настроить API-ключ

Минимальная схема подключения чата

Для Telegram схема такая же: обработчик бота вызывает ваш сервер, а не раздаёт API-ключ подписчикам. Токен самого Telegram-бота и ключ нейросети — разные секреты. Храните их отдельно и не пересылайте в текстовых сообщениях.

• Создайте отдельный ключ CLODEX для бота и задайте ограничение расхода.
• Выберите модель из каталога своего ключа и проверьте поддержку Chat Completions либо другого нужного протокола.
• На своём backend проверьте сессию пользователя, размер сообщения и допустимую частоту обращений.
• Передайте сообщение модели, обработайте ошибку или ответ и верните результат клиенту.

Пример запроса к API чата

Задайте CLODEX_API_KEY и CLODEX_MODEL в защищённом окружении своего сервера. Пример ниже подходит только для модели с поддержкой Chat Completions. Он выполнит запрос генерации и использует баланс, если вы его запустите; чтение страницы ничего не отправляет.

Некоторым моделям нужен Responses API или Messages API. Не подменяйте формат автоматически при ошибке. Сначала сверяйте ID модели и поддерживаемый маршрут с документацией, затем выполняйте короткий тест.

import json, os, urllib.request

# Choose a model that supports Chat Completions.
payload = {
    "model": os.environ["CLODEX_MODEL"],
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": False,
}
request = urllib.request.Request(
    "https://clodex.xyz/v1/chat/completions",
    data=json.dumps(payload).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["CLODEX_API_KEY"],
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))

Протоколы и документация · GPT API и ChatGPT API-сценарии

История сообщений и контекст пользователя

Список messages формируйте для текущего диалога. Не смешивайте переписку разных пользователей и не считайте каждый запрос автоматически связанным с предыдущим. Правила хранения и передачи контекста зависят от выбранного API и реализуются явно.

Ограничивайте историю по размеру, удаляйте ненужные персональные данные и учитывайте стоимость повторной передачи текста. Системные правила приложения храните отдельно от сообщений пользователя; содержимое загруженных файлов не должно давать модели административные права.

Потоковый ответ и обработка ошибок

Streaming позволяет показывать ответ частями, но интерфейс должен различать промежуточный текст и завершённый результат. Отмена пользователем, сетевой обрыв или таймаут не равны успешному завершению протокола. Сохраняйте безопасный идентификатор запроса для диагностики.

Повторяйте запрос только после определения причины сбоя. Если бот уже отправил сообщение или вызвал внешний инструмент, повтор может продублировать действие. Платёжные, административные и другие необратимые операции подтверждайте и проверяйте на стороне вашего сервера.

Цена API чат-бота и лимиты

Расход зависит от модели, длины входного контекста, ответа и тарифа. Длинная история поддержки может стоить больше короткой генерации текста. Смотрите единицу расчёта и условия кэша, а не только рекламное слово «дешёвый».

Помимо квоты ключа задайте собственные ограничения на пользователя, размер вложений и число параллельных диалогов. Сравните фактическую стоимость нескольких типовых обращений перед массовым запуском. Эта страница не обещает фиксированную цену за разговор или неограниченный бесплатный доступ.

Каталог цен · Выбор и сравнение LLM API