Пошаговая интеграция API LLM uncensored.com

Предварительные требования: SDK и настройка окружения

Установите предпочитаемый язык SDK для взаимодействия с конечной точкой. Большинство разработчиков используют официальный SDK OpenAI для Python, Node.js или Go. Это работает, потому что API следует стандартной схеме чат-завершений OpenAI.

Убедитесь, что в вашей среде установлен Python 3.8+ или Node.js 18+. Установите пакет через pip или npm. Вам понадобится API-ключ из панели управления. Для регистрации не требуется номер телефона.

• Python: pip install openai
• Node.js: npm install openai

Сохраните ваш API-ключ в переменной окружения. Это предотвратит случайное раскрытие в системе контроля версий. Ключ предоставляет доступ к uncensored-модели.

Настройка базового URL

Укажите базовый URL нашего SDK-клиента для правильного базового URL. Это самый критичный шаг для успешной интеграции. Стандартный базовый URL OpenAI не будет работать для этого сервиса.

Укажите базовый URL на HTTPS://api.uncensoredaicom.com/v1. Это направляет запросы в инфраструктуру uncensored LLM. Идентификатор модели, который вы должны отправить, — "uncensored". Это модель с открытыми весами, настроенная на минимальное количество отказов.

Проверьте подключение, вызвав конечную точку моделей. Это подтверждает, что ваши учетные данные и базовый URL верны. Успешный ответ возвращает ID модели и тип объекта.

Аутентификация и настройка заголовка

Передавайте ваш API-ключ в заголовке Authorization. Используйте схему Bearer для всех запросов. Этот заголовок аутентифицирует ваш предоплаченный аккаунт.

Установите заголовок следующим образом: Authorization: Bearer YOUR_API_KEY. SDK автоматически обрабатывает это, если вы передаете ключ в конструктор клиента. Убедитесь, что не содержит лишних пробелов. Неверные ключи возвращают ошибку 401 Unauthorized.

Вы получаете один активный ключ на аккаунт. Генерация нового ключа делает предыдущий недействительным. Это упрощает ротацию ключей и управление безопасностью. Храните ключ в безопасности в среде развертывания.

Отправка стандартного запроса чата

Отправьте POST-запрос на /v1/chat/completions. Отправьте сообщения в виде массива объектов с ролями и содержимым. Система поддерживает роли user, assistant и system.

Пример структуры: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API возвращает текстовое завершение. Контекстное окно составляет 100,000 токенов в общей сложности. Максимальный вывод — 16,000 токенов за запрос.

Ошибки и отказы не потребляют кредит. Это защищает ваш предоплаченный баланс. Установите temperature и top_p для контроля. Значения по умолчанию подходят для большинства случаев использования.

Включение потоковой передачи для вывода в реальном времени

Установить stream: true в тело запроса. Это активирует события, отправляемые сервером (SSE). Токены поступают инкрементально, а не после ожидания полного завершения.

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

Обрабатывайте сетевые прерывания корректно. Переподключайтесь, если поток прерывается. API uncensored поддерживает стабильную потоковую передачу. Мониторьте состояние соединения. Используйте это для интерфейсов чата или генерации длинных текстов.

Использование Tools и Function Calling

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

Specify tool_choice для управления выбором функции. Используйте auto для автоматического определения. API поддерживает стандартные определения инструментов. Разберите аргументы вызова функции из ответа.

Реализуйте выполнение функции в вашем коде. Отправьте результат обратно как сообщение. Модель продолжает разговор. Это позволяет сложные рабочие процессы. Тестирование обеспечивает точное разделение аргументов.

Обработка ответов в режиме JSON

Установить response_format: {"type": "json_object"}. Это заставляет модель выводить валидный JSON. Используйте это для извлечения структурированных данных. Это предотвращает ошибки некорректных ответов.

Анализируйте JSON-строку в своем коде. Обрабатывайте возможные ошибки парсинга. Режим JSON повышает надежность для API-интеграций. Он идеально подходит для конвейеров обработки данных.

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

Мониторинг лимитов и ошибок

Соблюдайте лимиты частоты запросов. Вам доступно 300 запросов в минуту на ключ. Максимум 8 одновременных запросов. Размер тела запроса ограничен 8 МБ.

Мониторинг кодов состояния HTTP. 429 указывает на превышение лимита скорости. 400 указывает на неверный запрос. 500 указывает на ошибку сервера. Реализуйте экспоненциальное замедление для повторных попыток. Это предотвращает перегрузку API.

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

Расчет стоимости и использования токенов

Цены прозрачны и по предоплате. Входные токены стоят $0.15 за миллион. Выходные токены стоят $0.50 за миллион. Кредиты не истекают. Ежемесячные платежи не применяются.

Пополните баланс только криптовалютой. USDT (TRC20) или USDC (Base). Суммы варьируются от $20 до $500. Бонусный кредит применяется за крупные пополнения. +5% от $50, +10% от $100, +15% от $200.

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