Быстрый старт API Uncensored AI

Предварительные требования и настройка базового URL

Начните с регистрации аккаунта через Google или email на странице ключей. Ваш API-ключ появляется мгновенно и служит единственным учетным данным для всех запросов. Базовый URL сервиса находится по адресу https://api.uncensoredroleplayai.com/v1, что работает с любым клиентом, совместимым с OpenAI.

Настройте переменную окружения или клиент SDK, указав этот URL. Этот единственный эндпоинт обрабатывает все текстовые завершения. Вам не нужно управлять маршрутизацией моделей или выбирать из нескольких поставщиков. Идентификатор модели всегда uncensored, модель с открытым весом, настроенная на взрослый и художественный контент.

Аутентификация с помощью API-ключей

Включите ваш API-ключ в Authorization заголовок как Bearer-токен. Каждый запрос должен содержать этот заголовок для аутентификации вашей личности. Если ключ отсутствует или недействителен, сервер возвращает ошибку 401 Unauthorized. Проверьте панель управления аккаунтом, если подозреваете, что ключ был отозван.

В каждом аккаунте одновременно активен только один ключ. Генерация нового ключа немедленно заменяет старый. Нет ограничений на количество исторически сгенерированных ключей, но работает только текущий. Используйте этот единственный ключ во всех ваших сервисах.

Отправка вашего первого завершения чата

Отправьте POST-запрос на /v1/chat/completions endpoint. endpoint. Передайте имя модели uncensored и историю вашего разговора в messages массив. Система возвращает текстовый ответ без фильтрации для законных тем для взрослых.

• Установите модель на uncensored.
• Включите ваш системный промпт для определения роли в ролевой игре.
• Отправляйте сообщения от имени пользователя, чтобы развивать повествование.

Проверьте, что структура ответа содержит сгенерированный текст. Это подтверждает, что ваша интеграция работает корректно с uncensored LLM API.

Обработка потоковых ответов

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

Подробности об использовании токенов появляются в последнем чанке. Это позволяет точно отслеживать расходы, не дожидаясь завершения всего ответа. Стриминг идеален для ролевых ботов, где важна задержка. Используйте Node SDK для легкой обработки этих событий.

Настройка параметров для ролевой игры

Настройте параметры, такие как temperature и top_p для управления креативностью. Более высокие температуры дают более разнообразные и непредсказуемые результаты. Используйте stop последовательности для завершения ответов в определенных фразах. JSON-режим доступен через response_format для структурированных данных.

Установить max_tokens для контроля длины вывода. Значение по умолчанию составляет 2 048 токенов, но вы можете запросить до 16 000. Контекстное окно поддерживает до 100 000 токенов в целом. Это обеспечивает непрерывность длинных текстов без потери контекста. Настройте эти параметры под ваш конкретный сценарий использования.

Понимание использования токенов и ценообразования

Прозрачное ценообразование: $0.15 за миллион входных токенов и $0.50 за миллион выходных токенов. Ошибки и отказы бесплатны. Кредит предоплачен и не истекает. Пополнение через криптовалюту: USDT (TRC20) или USDC (Base).

Лимиты включают 300 запросов в минуту и 8 одновременных запросов на ключ. Размер тела запроса ограничен 8 МБ. Если у вас закончатся средства, вы получите ошибку 402 Payment Required. Отслеживайте использование через панель управления, чтобы избежать прерываний.

cURL

Copycurl https://api.uncensoredroleplayai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
  }'

Python

Copyfrom openai import OpenAI

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