Документація для необмеженого API

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

Ваш API-ключ автентифікує кожен запит. Використовуйте базовий URL HTTPS://api.uncensores.cc/v1 із будь-яким стандартним OpenAI SDK. Ідентифікатор моделі — "uncensored". Передайте свій ключ у заголовку Authorization як токен Bearer. Ви можете згенерувати ключ через панель керування, використовуючи Google або електронну пошту. Кожен обліковий запис має один активний ключ, який замінює попередній.

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

Ви повинні включити поле model у кожен запит. Ендпоінт очікує масив messages, що містить історію вашої розмови. Якщо ключ відсутній або недійсний, API повертає помилку 401. Це забезпечує доступ лише авторизованим користувачам, які використовують ваш передоплачений кредит.

Чат-ендпоінт (Chat Completions Endpoint)

Надсилайте запити POST до /v1/chat/completions для генерації тексту. Цей ендпоінт обробляє стандартні діалогові запити та повертає структуровані текстові відповіді. Він не підтримує вбудовування (embeddings) чи генерацію зображень. Ви надаєте повідомлення system, user та assistant для керування моделлю. Модель відповідає вмістом у вигляді необробленого тексту всередині масиву choices.

Copyfrom openai import OpenAI

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

Ініціалізуйте клієнта, вказавши базовий URL та ключ. Визначте список повідомлень із бажаною роллю та вмістом. Викличіть метод chat.completions.create. Об'єкт відповіді містить згенерований текст та статистику використання. Цей прямий підхід усуває складність маршрутизації для завдань NSFW або творчого письма.

Потокові відповіді з SSE

Увімкніть потокову передачу, встановивши stream у значення true в запиті. API повертає події, надслані сервером (SSE), у міру появи токенів. Це зменшує сприйнятну затримку для довгих виводів. Кожен фрагмент містить частковий дельта-контент відповіді. Вам потрібно накопичувати ці дельта-контенти, щоб відновити остаточний текст.

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)

Останній фрагмент включає повну статистику використання для запиту. Це дозволяє відстежувати споживання токенів у реальному часі. Потокова передача ідеально підходить для чат-інтерфейсів, де користувачі очікують миттєвого зворотного зв'язку. Вона бездоганно працює з форматом виводу uncensored моделі.

Function Calling та режим JSON

API підтримує виклик функцій через параметр tools. Визначте схему своєї функції в запиті та встановіть tool_choice як auto або конкретне ім’я. Модель повертає виклики функцій у відповіді замість звичайного тексту. Ви також можете примусово виводити JSON, встановивши response_format у json_object. Це гарантує передбачуване парсингування для автоматизованих робочих процесів.

Copyimport OpenAI from "openai";

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

Передайте визначення інструментів у масив tools. Модель обиратиме відповідну функцію на основі вхідних даних. Ви отримаєте назву функції та аргументи у відповіді. Ця функція працює поруч із стандартними завершеннями чату без додаткових кінцевих точок. Використовуйте її для вилучення структурованих даних або поведінки, подібної до агента.

Параметри: Temperature, Top-P, Seeds

Налаштуйте temperature для контролю випадковості. Значення вище 1 підвищують креативність, тоді як значення нижче 1 роблять вивід більш детермінованим. Використовуйте top_p, щоб обмежити вибірку верхнім відсотком ймовірнісної маси. Встановіть seed для відтворюваних результатів при однакових запитах. Ці параметри дозволяють точно налаштувати стиль виводу uncensored-моделі.

Ви також можете використовувати послідовності стопу, щоб зупинити генерацію на певних рядках. presence_penalty та frequency_penalty допомагають зменшити повторення. Стандартна температура становить 1.0. Налаштування цих параметрів допомагає оптимізувати рольову гру або технічне письмо. Кожен запит підтримує ці стандартні параметри, сумісні з OpenAI.

Ліміти токенів та вікно контексту

Вікно контексту підтримує загальну кількість 100 000 токенів для запиту та відповіді. Ви можете отримувати до 16 000 токенів за запит. Якщо ви опускаєте max_tokens, значення за замовчуванням становить 2 048 токенів. Цей ліміт застосовується до сумарного вводу та виводу. Запити, які перевищують розмір тіла в 8 МБ, будуть відхилені. API встановлює ліміт швидкості на рівні 300 запитів на хвилину. Паралельні запити обмежені 8 на ключ. Помилки, такі як 402 (немає коштів) або 429 (перевищено ліміт), надають зрозумілий зворотний зв'язок. Невитрачені кошти ніколи не згорають, що гарантує оплату лише за фактичне використання.