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

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

API требует токен Bearer для каждого запроса. Сгенерируйте свой ключ на странице Get API key, войдя в систему через Google или пароль по электронной почте. Ключ появляется сразу без проверки телефона. Используйте базовый URL https://api.uncensoredaigithub.com/v1 с официальными SDK OpenAI, обновив base_url и api_key значения. Эта настройка работает с любым клиентом, совместимым с OpenAI.

Конечная точка: https://api.uncensoredaigithub.com/v1

Заголовок Auth: Authorization: Bearer YOUR_API_KEY

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

Эндпоинт Chat Completions

Отправляйте текстовые запросы в /v1/chat/completions эндпоинт с использованием идентификатора модели uncensored. API принимает стандартные сообщения для чата и возвращает текстовые ответы без фильтров контента для законного использования взрослыми. Вы можете настроить параметры, такие как temperature, top_p, и stop для управления креативностью и длиной вывода.

Окно контекста поддерживает до 100 000 токенов для промпта и завершения в сумме. Установите max_tokens для контроля вывода, со значением по умолчанию 2 048 токенов, если параметр не указан. Ошибки и отказы не списывают кредит, поэтому вы можете безопасно тестировать.

Потоковые ответы и использование

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

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

Function Calling и инструменты

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

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

Режим JSON и параметры

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

Другие поддерживаемые параметры включают seed для детерминированных результатов, presence_penalty, и frequency_penalty. Используйте seed для воспроизведения конкретных ответов при отладке. Настройте штрафы, чтобы уменьшить повторения или стимулировать разнообразие словарного запаса в ваших выводах.

Обработка ошибок и лимиты

API накладывает ограничение на частоту запросов: 300 запросов в минуту и не более 8 одновременных запросов на ключ. Размер тела запроса не должен превышать 8 МБ. При превышении этих лимитов возвращается код статуса 429. Ошибки аутентификации возвращают код 401. Недостаток средств на балансе вызывает ошибку 402.

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

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Потоковая передача

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)