Документация API

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

API требует один API-ключ для аутентификации. Вы получаете этот ключ сразу после регистрации через Google или адрес электронной почты. Передайте его в Authorization заголовок как Bearer-токен. Базовый URL https://api.topuncensored.com/v1. Этот URL работает с любым SDK или библиотекой клиентов, совместимой с OpenAI.

• Используйте заголовок: Authorization: Bearer YOUR_API_KEY
• Установите базовый URL клиента в указанную конечную точку.

Эта конфигурация позволяет заменять библиотеки без изменения основной логики.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Эндпоинт Chat Completions

Отправляйте текстовые промпты в /v1/chat/completions эндпоинт. Идентификатор модели uncensored. Этот эндпоинт обрабатывает стандартное форматирование чата с сообщениями. Он возвращает текстовые ответы напрямую. Нет дополнительных слоев или обертываний. Вы управляете контекстным окном в 100,000 токенов. Запросы до 8 МБ работают надежно. Используйте это для прямой генерации текста.

Структурируйте запрос с системным промптом и сообщением user. Модель отвечает без фильтрации законного контента для взрослых. Ошибки вроде отсутствующих ключей возвращают 401. Закончились кредиты? Вы получите ошибку 402. Это чёткие сигналы.

Потоковые ответы

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

Анализируйте каждый чанк для формирования финального ответа. Этот метод корректно обрабатывает большие объемы вывода. API поддерживает стандартные Server-Sent Events. Это рекомендуемый подход для интерактивных приложений.

Copyfrom openai import OpenAI

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

Вызов инструментов и режим JSON

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

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

Copyimport OpenAI from "openai";

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

Параметры и лимиты

Настроить temperature, top_p, и stop последовательности. Установите max_tokens to 16,000. Default is 2,048 if omitted. Control repetition with presence_penalty и frequency_penalty. Используйте seed для детерминированных результатов. Эти параметры настраивают качество генерации. Вы полностью контролируете стиль вывода.

Лимиты составляют 300 запросов в минуту. Одновременные запросы ограничены 8. Эти лимиты обеспечивают стабильную производительность. Следите за использованием через панель управления. Настройте параметры для оптимизации под ваш конкретный случай использования.

Ошибки и контекстное окно

Корректная обработка ошибок. Код 401 означает недействительный ключ. Код 402 указывает на недостаток средств. Код 429 сигнализирует о превышении лимита. Размер контекстного окна составляет 100,000 токенов суммарно. Максимальный объем вывода — 16,000 токенов. Рационально управляйте токенами. Ошибки не списывают средства. Это экономит деньги при отладке. Используйте последний чанк для получения статистики использования.

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

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)