Документация по нефильтрованному API

Аутентификация и базовый URL

Ваш API-ключ аутентифицирует каждый запрос. Используйте базовый URL HTTPS://api.uncensores.cc/v1 с любым стандартным OpenAI SDK. Идентификатор модели — "uncensored". Передайте ваш ключ в заголовке Authorization как Bearer token. Вы можете сгенерировать ключ через панель управления, используя Google или email. В аккаунте хранится один активный ключ, который заменяет предыдущий.

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

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

Эндпоинт Chat Completions

Отправляйте запросы POST на /v1/chat/completions для генерации текста. Этот эндпоинт обрабатывает стандартные диалоговые запросы и возвращает структурированные текстовые ответы. Он не поддерживает эмбеддинги или генерацию изображений. Вы предоставляете сообщения system, user и assistant для управления моделью. Модель отвечает сырым текстовым содержимым внутри массива choices.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensores.cc/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)

Инициализируйте клиент, передав базовый URL и ключ. Определите список сообщений с желаемой ролью и содержимым. Выполните метод chat.completions.create. Объект ответа содержит сгенерированный текст и статистику использования. Этот прямой подход устраняет сложность маршрутизации для задач NSFW или творческого письма.

Потоковые ответы с SSE

Включите потоковую передачу, установив stream в true в запросе. API возвращает Server-Sent Events (SSE) по мере появления токенов. Это снижает воспринимаемую задержку для длинных выводов. Каждый чанк содержит частичную дельту ответа. Вы должны накапливать эти дельты, чтобы восстановить финальный текст.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

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

Function Calling и режим JSON

API поддерживает вызов функций через параметр tools. Определите схему вашей функции в запросе и установите tool_choice в auto или конкретное имя. Модель возвращает вызовы функций в ответе вместо обычного текста. Вы также можете принудительно вывести JSON, установив response_format в json_object. Это обеспечивает предсказуемое разделение данных для автоматизированных рабочих процессов.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensores.cc/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);

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

Параметры: Temperature, Top-P, Seeds

Настраивайте temperature для управления случайностью. Значения выше 1 повышают креативность, а значения ниже 1 делают выходные данные более детерминированными. Используйте top_p для ограничения сэмплирования верхним процентом вероятностной массы. Установите seed для воспроизводимых результатов при идентичных запросах. Эти параметры позволяют тонко настраивать стиль вывода uncensored модели.

Вы также можете использовать последовательности остановки для завершения генерации на определенных строках. presence_penalty и frequency_penalty помогают уменьшить повторения. Температура по умолчанию равна 1.0. Настройка этих параметров помогает оптимизировать процесс для ролевой игры или технического письма. Каждый запрос поддерживает эти стандартные параметры, совместимые с OpenAI.

Лимиты токенов и контекстное окно

Окно контекста поддерживает до 100 000 токенов суммарно для промпта и завершения. Вы можете вывести до 16 000 токенов за запрос. Если вы опустите параметр max_tokens, значение по умолчанию составит 2 048 токенов. Этот лимит применяется к суммарному объему ввода и вывода. Запросы с телом размером более 8 МБ будут отклонены. API устанавливает лимит частоты запросов на уровне 300 запросов в минуту. Одновременные запросы ограничены 8 на ключ. Ошибки 402 (нет средств) или 429 (превышен лимит) дают четкую обратную связь. Непотраченный баланс не сгорает, что гарантирует оплату только за фактическое использование.