Документация API для разработчиков

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

Подключитесь к нашей инфраструктуре, указав в клиенте назначенный базовый URL и предоставив ваш уникальный ключ API. Мы используем стандартную аутентификацию через заголовки, поэтому вы можете заменить наш эндпоинт в существующих конфигурациях SDK OpenAI без переписывания основной логики. На один аккаунт выдается один активный ключ, и немедленная генерация нового ключа делает предыдущий недействительным. Такой дизайн делает интеграцию простой, сохраняя четкий контроль доступа. Зарегистрируйтесь через Google или email, чтобы мгновенно увидеть свой ключ. Мы не требуем номер телефона или метод оплаты для начала.

• Базовый URL: https://api.uncensoreai.com/v1
• Заголовок Auth: Authorization: Bearer YOUR_API_KEY

Первый запрос (POST /v1/chat/completions)

Отправьте свое первое завершение, отправив полезный груз JSON в эндпоинт завершения чата. Идентификатор модели — uncensored и он принимает стандартные структуры сообщений с ролями system, user и assistant. Вы получаете мгновенный текстовый вывод без сложной маршрутизации или логики выбора модели. Ошибки не расходуют ваши предоплаченные кредиты, поэтому вы можете тестировать бесплатно. Модель обрабатывает генерацию с открытым весом, настроенную на контент для взрослых, без отказов. Используйте эту структуру для начала интеграции.

Интеграция Python SDK

Используйте официальный Python клиент для бесшовного взаимодействия с нашим API. Установите базовый URL и API-ключ в объекте конфигурации перед выполнением вызовов. Библиотека автоматически обрабатывает сериализацию JSON и разбор ответов. Вы можете получить данные об использовании напрямую из объекта ответа. Этот подход работает в любой стандартной среде Python, поддерживающей асинхронные или синхронные запросы. Храните ваш ключ в переменных окружения. Пример кода демонстрирует базовый синхронный вызов.

Интеграция SDK Node.js

Интегрируйтесь с проектами на Node.js, используя стандартный менеджер пакетов. Импортируйте клиент и настройте базовый URL так, чтобы он указывал на наши серверы. SDK управляет HTTP-запросами и предоставляет типизированные ответы для пользователей TypeScript. Вы можете легко добавить заголовки или изменить таймауты при необходимости. Этот метод подходит для современных веб-приложений и бэкенд-сервисов. Убедитесь, что ваша версия Node совместима с требованиями SDK. Следующий пример показывает простой запрос на завершение.

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

Включите вывод в реальном времени, установив stream флаг в true в вашем запросе. API возвращает Server-Sent Events (SSE) по мере генерации токенов. Вы можете мгновенно отображать текст пользователям, не дожидаясь полного ответа. Детали использования токенов появляются в последнем чанке потока. Эта функция снижает воспринимаемую задержку для длинных выводов. Отслеживайте баланс кредита по мере накопления токенов. Потоковая передача работает со всеми стандартными параметрами, такими как temperature и stop sequences.

Лимиты, Ошибки и Контекстное окно

В вашем аккаунте окно контекста составляет 100,000 токенов для промпта и завершения в сумме. Вы можете отправить до 16,000 токенов в одном ответе, если укажете max_tokens. Стандартный лимит вывода — 2,048 токенов, если вы опустите этот параметр. Лимиты скорости позволяют выполнять 300 запросов в минуту и 8 одновременных запросов на ключ. Статус 401 означает, что ваш ключ недействителен. Статус 402 указывает на недостаточный предоплаченный кредит. Статус 429 означает, что вы превысили лимит скорости. Тела запросов не должны превышать 8 МБ.

cURL

Copycurl https://api.uncensoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the current server status from the api endpoint"}]
  }'

Python

Copyfrom openai import OpenAI

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