FAQ Uncensored API

Основы

Что такое Uncensored API в одном предложении?

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

Какой URL вызывать?

Используйте https://api.uncensoredapis.com/v1 как базовый URL. Запросы на чат отправляются через POST /v1/chat/completions, список моделей доступен по GET /v1/models. Любой другой путь возвращает 404.

Нужно ли учить новый SDK?

Нет. Форматы запроса и ответа соответствуют стандарту чат-завершений, поэтому официальные пакеты Python и Node.js работают после смены базового URL и ключа. Обычный curl тоже работает, как показано в документации.

Можно ли попробовать перед оплатой?

Да. Новому аккаунту начисляется пробный баланс $0,50 на 7 дней, данные оплаты не запрашиваются при регистрации. Зарегистрируйтесь по email и паролю на странице ключей, и ключ отобразится сразу.

Можно ли выбрать одну из нескольких моделей?

Нет. Модель ровно одна, её id — uncensored. Запрос к маршруту моделей возвращает только эту запись, выбирать или переключать нечего.

Для кого предназначен сервис?

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

Ключи и доступ

Сколько ключей получает аккаунт?

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

Где должен храниться ключ?

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

Как отправляется ключ?

В заголовке Authorization: Bearer каждого запроса. Пропущенное или неверное значение возвращает 401 с JSON-объектом ошибки.

Мне нужен API-ключ без цензуры для команды. Можно ли им делиться?

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

Лимиты и цены

Каким может быть промпт?

Контекстное окно — 100 000 токенов, делится между промптом и завершением. Тело одного запроса не должно превышать 8 МБ. Запрос, при котором промпт плюс max_tokens превысили бы окно, будет отклонён (400).

Каким может быть ответ?

По умолчанию — 2048 токенов. Вы можете увеличить max_tokens до 32 000 на запрос. Если ответ обрезается из-за лимита, finish_reason будет равен length.

Сколько это стоит?

Токены ввода — $0,25 за миллион, токены вывода — $1,00 за миллион. Баланс предоплаченный, подписки нет, баланс не сгорает. См. страницу цен для таблицы.

Можно ли дать быструю оценку?

Предположим разговорный ход с 1 500 токенами промпта и 300 токенами завершения, чисто для иллюстрации. Это $0,000375 за входные и $0,0003 за выходные, или около $0,000675 за ход, так что $1 покупает примерно 1 480 таких ходов.

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

На ключ приходится 300 запросов в минуту. При превышении вы получите 429; правильный ответ — замедлиться и повторить запрос с задержкой.

Вопросы по интеграции

Какие параметры сэмплирования можно задать?

Стандартные параметры, такие как temperature, top_p и stop, передаются в генерацию. Устанавливайте их в теле запроса так же, как и в других API.

Запоминает ли API предыдущие реплики?

Нет. Каждый запрос независим, поэтому каждый раз отправляйте весь разговор в поле messages. Убирайте самые старые ходы, когда общий объем приближается к окну в 100 000 токенов.

Могу ли я получать токены потоком в браузер?

Да, отправьте stream: true и читайте server-sent events. Делайте это на бэкенде и передавайте текст на страницу, чтобы ключ никогда не попадал к клиенту.

Поддерживаются ли системные сообщения?

Да. Поместите сообщение с ролью system первым в массиве, чтобы задать тон, формат и границы диалога.

Что проверить в первую очередь, если вывод обрезан?

Посмотрите на finish_reason. Значение length означает, что достигнуто ограничение, поэтому увеличьте max_tokens или сократите промпт. Список всех значений приведён в reference.

Баланс и оплата

Как пополнить баланс?

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

Что происходит, когда заканчивается пробный баланс?

Пробный баланс действует 7 дней. После его расходования или истечения срока запросы возвращают код 402 с кодом ошибки no_credit, пока вы не пополните баланс.

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

Каждый ответ содержит блок usage с токенами промпта, завершения и общего количества. Умножьте на тариф за миллион, чтобы получить стоимость, и ведите свой учет, если нужен журнал расходов.

Можно ли бесплатно повторить неудачные запросы?

Повторные запросы разрешены, но держите их в разумных пределах. Используйте короткую задержку для 429 и 503, никогда не зацикливайтесь на 400, 401, 402 или 403, так как они не исправятся сами. В руководстве по ошибкам есть готовая политика.

Контент и поведение

Что модель не делает?

Законный контент для взрослых не блокируется, как и художественная литература или спорные темы. Единственное строгое ограничение — любой контент сексуального характера с участием несовершеннолетних, который всегда блокируется (403), включая истории и ролевые игры. Сервис для взрослых старше 18 лет.

Используются ли мои промпты для обучения модели?

Нет. Промпты не используются для обучения.

Чем это отличается от маршрутизации через агрегатор?

Агрегаторы перенаправляют вас к множеству моделей с собственными правилами. Этот сервис — одна модель с одной политикой. В руководстве по Uncensored OpenRouter это сравнение разобрано подробно.

Может ли он видеть изображения или создавать эмбеддинги?

Нет. Он работает только с текстом, без эмбеддингов, изображений, аудио, видео и дообучения.

Устранение неполадок

Получаю 402 с no_credit. Что делать?

Ваш баланс исчерпан или истёк пробный период. Пополните предоплаченный баланс и отправьте запрос снова.

Запрос возвращает 503 upstream_busy.

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

Мой поток заканчивается, и я не могу найти подсчёт токенов.

При потоковой передаче в конце автоматически добавляется чанк с usage, прямо перед data: [DONE]. Его список choices пуст, поэтому проверяйте это перед индексацией.

Работают ли инструменты и вызов функций?

Да, в стандартном формате: передайте массив tools и ищите tool_calls в ответе.