Как интегрировать API Uncensored AI

Почему стоит выбрать API Uncensored AI?

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

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

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

Настройка среды

Интеграция начинается с указания совместимого с OpenAI SDK на правильный базовый URL. Эндпоинт размещен по адресу https://api.uncensoredai.top/v1. Это означает, что вы можете использовать официальные библиотеки OpenAI Python или Node.js без переписывания логики клиента. Вам нужно только обновить параметр base_url и предоставить API-ключ.

Сервис поддерживает контекстное окно на 100 000 токенов, что значительно больше, чем у многих стандартных предложений. Это позволяет обрабатывать обширные истории промптов или большие документы. Имейте в виду, что максимальный вывод на запрос составляет 32 000 токенов. Если вы не укажете max_tokens, значение по умолчанию составляет 2 048 токенов.

• Совместимость SDK: Работает с любым клиентом, поддерживающим протокол Chat Completions OpenAI.
• Контекстное окно: 100k токенов всего (вход + выход).
• Максимальный вывод: 16k токенов на запрос.

Убедитесь, что переменные среды настроены правильно, чтобы избежать проблем с задержкой. API предназначен для прямой интеграции на уровне кода, поэтому веб-интерфейса для изучения нет. Вы взаимодействуете с ним исключительно через HTTP-запросы.

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

Аутентификация осуществляется через стандартный заголовок Authorization. Вы получите один API-ключ при регистрации. В отличие от сервисов, выпускающих несколько ключей на аккаунт, эта платформа требует один активный ключ на аккаунт. Если вы сгенерируете новый ключ, предыдущий будет немедленно аннулирован.

Для аутентификации запроса включите заголовок: Authorization: Bearer YOUR_API_KEY. Сервис также предоставляет эндпоинт GET /v1/models, который возвращает информацию о доступных моделях, включая идентификатор модели uncensored. Это полезно для проверки подключения перед отправкой сложных полезной нагрузки.

Лимиты запросов:

• 300 запросов в минуту на ключ.
• 8 параллельных запросов одновременно на ключ.
• Максимальный размер тела запроса — 8 МБ.

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

Отправка первого запроса на генерацию

Базовый запрос следует стандартному формату Chat Completions. Вы отправляете полезную нагрузку JSON с параметром model, установленным в uncensored, и массивом messages. Сервис возвращает текстовый ответ. Эндпоинтов эмбеддингов, визуального анализа или аудио нет — это чистый текстовый API.

Пример запроса:

Следующий пример демонстрирует стандартное завершение чата. Замените YOUR_API_KEY на ваш фактический ключ.

Copycurl https://api.uncensoredai.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Ответ будет содержать сгенерированный текст в поле choices[0].message.content. Ошибки возвращаются в стандартном формате HTTP, что позволяет вам корректно обрабатывать повторные попытки или сбои. Обратите внимание, что ошибки не расходуют ваш баланс, поэтому вы можете тестировать бесплатно.

Для разработчиков, знакомых с OpenAI, опыт будет идентичным. Единственное отличие — базовый URL и поведение модели относительно фильтров контента. Эта согласованность снижает порог входа для команд, уже использующих инструменты, совместимые с OpenAI.

Обработка потоковых ответов

Потоковая передача поддерживается через Server-Sent Events (SSE). Это позволяет получать токены по мере их генерации, обеспечивая лучший пользовательский опыт для длинных ответов. Эндпоинт потоковой передачи такой же, как и для непотоковой передачи; вы просто устанавливаете параметр stream: true в запросе.

Преимущества потоковой передачи:

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

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

Пример кода:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredai.top/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Убедитесь, что ваша библиотека клиента правильно обрабатывает поток SSE. Большинство современных SDK абстрагируют это, но понимание базового протокола помогает при отладке проблем с подключением или ошибках парсинга.

Расширенные функции: JSON-режим и инструменты

API поддерживает структурированные выходные данные через параметр response_format, установленный в {"type": "json_object"}. Это заставляет модель возвращать действительный JSON, что необходимо для интеграции с другими программными системами. Эта функция особенно полезна для извлечения данных или генерации конфигурационных файлов.

Также поддерживается вызов функций. Вы можете определить инструменты в своем запросе, и модель вернет вызовы инструментов в ответе. Это позволяет создавать сложные рабочие процессы, где LLM может запускать внешние действия. Параметр tool_choice позволяет принудительно использовать определенные инструменты или позволить модели принять решение.

Ключевые параметры:

• temperature: Управляет случайностью.
• top_p: Управляет разнообразием.
• stop: Определяет стоп-последовательности.
• seed: Для детерминированных ответов.

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

Мониторинг использования и лимитов

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

Метрики использования:

• Входные токены: тарификация $0,25 за 1 млн токенов.
• Выходные токены: тарификация $1,00 за 1 млн токенов.
• Ошибки: бесплатно.

Вы можете настроить уведомления, если ваша клиентская библиотека это поддерживает, но основной мониторинг осуществляется через панель управления аккаунтом. Лимит в 300 запросов в минуту обеспечивает справедливое использование для всех пользователей. При превышении этого лимита вы получите код статуса 429.

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

Управление кредитами через криптовалюту

Платежи обрабатываются исключительно криптовалютой. Вы можете пополнить аккаунт с помощью USDT (TRC20) или USDC (Base). Минимальная сумма пополнения составляет $10, максимальная — $500. Ежемесячных подписок или регулярных платежей нет.

Бонусные кредиты:

• Пополнение на $50: +5% бонусных кредитов.
• Пополнение на $100: +10% бонусных кредитов.

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

Процесс оплаты:

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredai.top/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

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