uk ▾
Отримайте свій ключ

uncensoredroleplayai.com/Документація

Швидкий старт API Uncensored AI

Отримайте екземпляр AI для рольових ігор без цензури, який запускається за лічені хвилини за допомогою нашого API, сумісного з OpenAI. Використовуйте стандартні SDK для надсилання тексту та отримання відповідей з довгим контекстом без фільтрів контенту.

Передумови та налаштування базового URL

Почніть з реєстрації акаунту через Google або електронну пошту на сторінці ключів. Ваш API-ключ з’являється миттєво і є єдиним обліковим данним для всіх запитів. Базова URL-адреса сервісу є https://api.uncensoredroleplayai.com/v1, що працює з будь-яким клієнтом, сумісним з OpenAI.

Налаштуйте змінну середовища або клієнт SDK, щоб вказати на цей URL. Ця єдина кінцева точка обробляє всі текстові завершення. Вам не потрібно керувати маршрутизацією моделей або обирати з кількох постачальників. Ідентифікатор моделі завжди uncensored, модель з відкритими вагами, налаштована для дорослого та художнього контенту.

Аутентифікація за допомогою API-ключів

Включіть свій API-ключ у Authorization header as a Bearer token. Every request must carry this header to authenticate your identity. If the key is missing or invalid, the server returns a 401 Unauthorized error. Check your account dashboard if you suspect the key was revoked.

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

Надсилання вашого першого запиту на завершення чату

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

  • Встановіть модель на uncensored.
  • Додайте свій системний промпт для визначення ролі в рольовій грі.
  • Надсилайте повідомлення користувача, щоб розвивати сюжет.

Перевірте, чи містить структура відповіді згенерований текст. Це підтверджує, що ваша інтеграція коректно працює з API необмеженої LLM.

Обробка потокових відповідей

Увімкніть потокову передачу, встановивши stream для true у вашому запиті. API надсилає фрагменти через події, надіслані сервером (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

curl 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

from 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

import 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);

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

stream = 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)
01

Технічні запитання та відповіді

Який ліміт контексту uncensored roleplay AI?

Контекстне вікно підтримує 100,000 токенів як для запиту, так і для відповіді. Ви можете виводити до 16,000 токенів за один запит. Це дозволяє створювати довгі історії без втрати контексту. Все одно діють обмеження на вивід незначного сексуального контенту.

Як обробляти помилки автентифікації?

Помилка 401 вказує на недійсний або відсутній API-ключ. Перевірте панель керування обліковим записом, щоб переконатися, що ключ активний. Згенеруйте новий ключ, якщо старий було анульовано. Кожен обліковий запис має один активний ключ одночасно.

Що станеться, якщо я перевищу ліміт швидкості?

Ви отримаєте помилку 429 Too Many Requests. Ліміт становить 300 запитів на хвилину та 8 одночасних запитів. Зачекайте кілька секунд перед повторною спробою. Слідкуйте за своїм використанням, щоб залишатися в межах лімітів.

Отримайте свій API-ключ

Зареєструйтеся, скопіюйте токен, оновіть кінцеву точку. Це вся конфігурація.