Документация API & Быстрый старт

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

Начните каждый запрос, указав в вашем клиенте HTTPS://api.uncensoredia.com/v1 и прикрепив ваш ключ. Авторизация uses the standard Bearer схему, поэтому вам просто нужно вставить токен, полученный после регистрации через Google или email. Конечная точка полностью openai compatible API соответствует, что означает, что вам нужно просто заменить базовый URL и API-ключ в существующей конфигурации. Вам не нужно управлять сложными слоями маршрутизации или заголовками прокси. Просто убедитесь, что ваш Authorization header содержит ваш уникальный токен. Эта настройка гарантирует, что ваши запросы достигают выделенной uncensored-модели без промежуточной фильтрации. Если вы получите 401 ошибка, убедитесь, что ваш ключ активен и правильно отформатирован.

Эндпоинт Chat Completions

Отправляйте сообщения в POST /v1/chat/completions получать текстовые ответы от uncensored модели. Этот единственный эндпоинт обрабатывает все ваши потребности в генерации, от простых промптов до сложных многооборотных разговоров. Вы можете контролировать длину вывода и случайность с помощью таких параметров, как max_tokens, temperature, и top_p. Модель поддерживает огромный 100 000 токенов окно контекста, позволяющее загружать обширную документацию или длинные истории разговоров. Вы можете отправить до 16,000 токенов в ответе. Если вы опустите max_tokens, лимит по умолчанию составляет 2 048 токенов. Этот эндпоинт не поддерживает генерацию изображений или аудио. Это строго текст на вход, текст на выход. Используйте следующую команду curl, чтобы немедленно проверить подключение.

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

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

Настройка SDK Node.js

Интегрируйте API в ваши приложения JavaScript или TypeScript, используя @anthropic-ai/sdk или официальный openai пакет. Установите baseURL к конечной точке и укажите ваш API-ключ. Это позволяет вам использовать знакомые методы, такие как chat.completions.create() непосредственно. SDK обрабатывает HTTP-запросы и разбирает JSON-ответы за вас. Вы можете легко обрабатывать ошибки, такие как 402 (недостаточно кредитов) или 429 (rate limit) в логике вашего приложения. Эта настройка идеально подходит для веб-серверов, ботов или любой среды Node.js. Модель без цензуры работает бесшовно со стандартным форматом запросов. Настройте клиент, чтобы обеспечить совместимость с ожиданиями API.

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

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

Лимиты и контекстные ограничения

API накладывает строгие ограничения для обеспечения стабильной производительности для всех пользователей. Вы можете отправлять до 300 запросов в минуту per key и имеют 8 параллельных запросов активен в любое время. Максимальный размер тела запроса составляет 8 МБ. Если вы превысите эти лимиты, вы получите 429 код состояния. Убедитесь, что вы обрабатываете повторные попытки с экспоненциальной задержкой, чтобы не сталкиваться с этими лимитами снова и снова. Окно контекста составляет 100 000 токенов, но максимальный объем вывода ограничен 16 000 токенами. Если вам нужно больше вывода, измените max_tokens параметр. Ошибки типа 401 (неверный ключ) и 402 (нет кредитов) — мгновенные и не расходуют лимит токенов. Тщательно управляйте квотой, чтобы избежать прерывания сервиса при задачах с высокой нагрузкой на генерацию.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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