Uncensored Endpoint: Базовый URL, идентификатор модели и ограничения
Эндпоинт uncensored здесь — это размещённый текстовый API, совместимый с OpenAI, который отвечает без отказов по контенту для законного использования взрослыми. На этой странице указан точный базовый URL, идентификатор модели, методы, лимиты и коды ошибок, которые вам нужны перед тем, как писать код.
Ключевые моменты
- Базовый URL — https://api.uncensoredendpoint.com/v1, а единственный идентификатор модели — uncensored.
- Доступны два метода: POST /v1/chat/completions и GET /v1/models.
- Размер контекстного окна составляет 100 000 токенов, включая промпт и завершение.
- Полный ключ позволяет 8 одновременных запросов и 300 запросов в минуту.

Настройки подключения вкратце
Если вам нужны только значения, вот они. Всё остальное на этой странице объясняет, как они ведут себя на практике.
| Настройка | Значение |
|---|---|
| Базовый URL | https://api.uncensoredendpoint.com/v1 |
| ID модели | uncensored |
| Заголовок авторизации | Authorization: Bearer YOUR_KEY |
| Эндпоинты | POST /v1/chat/completions, GET /v1/models |
| Контекстное окно | 100 000 токенов, промпт плюс завершение |
| Максимальный размер тела запроса | 8 МБ |
| Полные лимиты ключей | 8 параллельных запросов, 300 запросов в минуту |
| Лимиты пробного ключа | 2 параллельных запроса, 60 запросов в минуту |
| Цена | $0,15 за 1 млн входных токенов, $0,50 за 1 млн выходных токенов |
Сервис использует тот же сетевой формат, что и API OpenAI chat completions. Если инструмент позволяет ввести пользовательский базовый URL и API-ключ, он может работать с этим сервисом. Вы получаете ключ на странице API-ключ, а документация содержит ту же справочную информацию в более краткой форме.
Что делает каждый метод
Существует только два маршрута, поэтому интерфейс остаётся небольшим.
GET /v1/modelsвозвращает список моделей. Вы увидите одну запись,uncensored. Многие клиенты вызывают этот маршрут для заполнения выпадающего списка моделей, поэтому это также быстрый способ подтвердить, что ваш ключ и URL верны.POST /v1/chat/completions— это рабочая лошадка. Он принимает список сообщений и возвращает завершение, либо как один JSON-ответ, либо как поток событий, отправляемых сервером (SSE).
Старый маршрут текстовых завершений, маршрут ответов, эмбеддинги, маршруты изображений и аудио не являются частью продукта. Если библиотека пытается использовать один из них, ожидайте ошибку и переключите библиотеку в режим чата.
Быстрая проверка из терминала:
curl https://api.uncensoredendpoint.com/v1/models \
-H "Authorization: Bearer $API_KEY"
JSON-список, содержащий uncensored, означает, что ключ работает. HTTP 401 означает, что ключ отсутствует, введён неверно или содержит лишний пробел или символ новой строки, что является самой частой причиной, когда ключ получен из переменной оболочки.
Ваш первый запрос в curl, Python и Node
Все три примера отправляют одно и то же: одно системное сообщение, одно пользовательское сообщение, низкую температуру. Замените YOUR_KEY или установите переменную окружения API_KEY.
curl https://api.uncensoredendpoint.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a context window is in two sentences."}
],
"temperature": 0.7
}'
С официальным Python SDK вы передаёте клиенту только два дополнительных аргумента:
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredendpoint.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a context window is in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
А в Node.js с тем же SDK:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredendpoint.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are a concise assistant." },
{ role: "user", content: "Explain what a context window is in two sentences." },
],
});
console.log(resp.choices[0].message.content);
Ответ включает объект usage с подсчётом токенов промпта и завершения. Следите за ним: эти два числа — это то, за что вы платите. Заголовки ответа также содержат X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency. Логируйте идентификатор запроса при каждом вызове, так как это первое, о чём попросит поддержка, если что-то пойдёт не так.
Потоковая передача, вызов инструментов и JSON-режим
Три функции покрывают большинство реальных приложений, и все три следуют схемам OpenAI, которые вам уже знакомы.
Потоковая передача
Установите stream: true и читайте события, отправляемые сервером. Использование сообщается в конце потока, поэтому вы всё ещё можете подсчитывать токены без второго запроса. Одна деталь важна для планирования мощности: потоковый запрос удерживает слот параллельности до завершения потока. Медленный клиент, который читает длинный ответ постепенно, держит слот занятым всё это время.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Вызов функций
Передайте tools и опционально tool_choice. Когда модель решает вызвать функцию, вы получаете tool_calls в ответе (также в потоке, если вы используете потоковую передачу). Вы запускаете функцию самостоятельно и отправляете результат обратно как сообщение с role: "tool". Модель — это одна модель с открытыми весами, поэтому протестируйте схемы ваших инструментов с несколькими реалистичными промптами и держите описания параметров краткими и дословными.
JSON-режим
Отправьте response_format: {"type":"json_object"}, чтобы запросить вывод в формате JSON. Также укажите в промпте, что вы хотите получить JSON, и опишите ожидаемые поля. Всё равно парсите с осторожностью и повторите попытку один раз при ошибке парсинга, а не доверяйте выводу вслепую.
Параметры сэмплирования передаются без изменений: temperature, top_p, stop, seed, а также штрафы за частоту и присутствие.
Окно на 100 000 токенов на практике
Контекстное окно составляет 100 000 токенов, и это число охватывает промпт и завершение вместе. Завершение может использовать всё, что осталось свободным в промпте, и max_tokens является необязательным. Если вы отправите 90 000 токенов промпта, на ответ останется не более примерно 10 000 токенов.
Приблизительное правило для английского текста: один токен — это немного меньше одного слова, поэтому 100 000 токенов — это порядка 70 000 слов. Этого достаточно для длинного набора глав рукописи, большого фрагмента кодовой базы или нескольких часов истории чата. Три привычки делают это полезным:
- Намеренно обрезайте историю. Клиенты чата отправляют весь разговор каждый ход, поэтому стоимость и задержка растут вместе с ним. Храните системный промпт, краткое содержание старых ходов и несколько последних сообщений.
- Устанавливайте
max_tokens, когда важен размер вывода. Это необязательно, но ограничение защищает вас от неконтролируемого ответа на длинном промпте. - Следите за лимитом тела в 8 МБ. Он отделен от окна токенов. Обычный текст редко достигает 8 МБ, но бинарные данные в base64, вставленные в промпт, могут.
Поскольку оплата начисляется за токен, запрос на полное окно стоит реальных денег по сравнению с коротким запросом. На странице тарифов указаны ставки, и вы можете рассчитать любой запрос как входные токены × $0,15 плюс выходные токены × $0,50, каждое число делится на один миллион.
Лимиты запросов и семейство 429
Полный ключ позволяет 8 запросов одновременно и 300 запросов в минуту. Пробный ключ более строгий: 2 одновременно и 60 в минуту. Когда вы пересекаете границу, API отвечает HTTP 429, а код ошибки указывает, какую именно:
| Код ошибки | Что значит | Что делать |
|---|---|---|
rate_limited | Слишком много запросов в минуту | Снизьте нагрузку; распределите вызовы в течение минуты |
concurrency | Слишком много одновременных запросов | Очередь на вашей стороне; ограничьте число параллельных воркеров до 8 (2 в пробной версии) |
429 с Retry-After: 5 | Временная перегрузка | Подождите 5 секунд, затем повторите попытку |
Самая простая защита — семафор в вашем собственном коде, настроенный на размер вашего ключа. В Python с asyncio, asyncio.Semaphore(8) вокруг каждого вызова полностью устраняет ошибку concurrency. Добавьте повторную попытку, которая учитывает заголовок Retry-After и переходит к короткой экспоненциальной задержке, если заголовок отсутствует. Помните, что потоки удерживают слот на всю свою длину, поэтому пакет из восьми длинных потоков заблокирует девятый запрос, даже если количество запросов в минуту низкое.
Неудачные или отклонённые запросы не оплачиваются, поэтому цикл повторных попыток не стоит вам денег за отклонённые попытки.
Что представляет собой модель и чем не является
Сервис работает на одной модели с открытыми весами, размещённой независимым провайдером и настроенной на ответы без отказов в выдаче контента для законного использования совершеннолетними. Это не официальный API какого-либо крупного вендора, и это не маршрутизатор, выбирающий между вендорами. Есть одна модель, uncensored, поэтому не из чего выбирать и нет уровней цен для сравнения.
Лимиты просты. Текст поступает на вход и текст возвращается. Нет генерации изображений, аудио или видео, нет векторных представлений и нет дообучения. Единственное правило по контенту: контент сексуального характера с участием несовершеннолетних никогда не разрешён. Промпты не используются для обучения.
Такой взгляд помогает при планировании проекта. Инструменты для художественной прозы и ролевых игр для взрослых, приложения-компаньоны, исследования поведения моделей и инструменты, работающие с прямым или чувствительным текстом без того, чтобы модель отказывалась, — всё это естественные варианты использования. Если вам нужны векторные представления для поиска, вам понадобится отдельный провайдер для этой части, и вы всё ещё можете использовать этот эндпоинт для генерации.
Перед выходом в продакшн
Рабочий демо-пример занимает пять минут. Надёжный сервис требует чуть больше времени. Начните с пробного периода: новые пользователи могут получить $0,50 кредита одним кликом на странице ключа после входа, один раз на человека, срок действия 7 дней, без необходимости оплаты. Вход возможен через Google или по электронной почте и паролю. Этого достаточно для сотен коротких тестовых вызовов, чтобы проверить интеграцию.
Когда вы переходите к реальному трафику, пополняйте на любую целую сумму от $20 до $500. Оплата криптовалютой (USDT в сети TRC20, USDC в сети Base). Кредит не сгорает, и нет подписки, поэтому баланс просто лежит, пока вы его не потратите. Бонус составляет 5% от $50, 10% от $100 и 15% от $200.
Затем пройдите по короткому списку: храните ключ в переменной окружения или в менеджере секретов, никогда не в клиентском коде; логируйте X-Request-Id; следите за X-Balance-USD, чтобы предупредить до исчерпания баланса; ограничьте параллельные воркеры; и обрабатывайте 429 с задержкой, а не в тесном цикле. Чек-лист по подготовке к продакшену для API-ключей подробно рассматривает обработку ключей, а в документации содержится справочник параметров.
Дополнительные руководства
Вопросы и ответы
Нужен ли мне специальный SDK?
Нет. Любой SDK или клиент OpenAI подойдёт. Измените базовый URL и ключ, установите модель uncensored, и остальной код остаётся прежним.
Может ли он генерировать изображения или векторные представления?
Нет. API работает только с текстом. Нет генерации изображений, аудио или видео, нет эмбеддингов и нет дообучения.
Что происходит, когда я достигаю лимита запросов?
Вы получите HTTP 429. Код ошибки — rate_limited, если превышен лимит запросов в минуту, и concurrency, если одновременно выполняется слишком много запросов. Подождите немного и повторите запрос.
Существуют ли строгие правила по контенту?
Да. Контент сексуального характера с участием несовершеннолетних всегда запрещён. Всё остальное модель отвечает без отказов, для законного использования взрослыми.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.