Документація API

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

API вимагає bearer-токен для кожного запиту. Згенеруйте свій ключ на сторінці Get API key, увійшовши через Google або пароль електронної пошти. Ключ з’являється миттєво без верифікації телефоном. Використовуйте базовий URL https://api.uncensoredaigithub.com/v1 за допомогою офіційних SDK OpenAI, оновивши base_url та api_key значення. Ця конфігурація сумісна з будь-яким OpenAI-сумісним клієнтом.

Точка доступу: https://api.uncensoredaigithub.com/v1

Заголовок Auth: Authorization: Bearer YOUR_API_KEY

Кожен обліковий запис підтримує один активний ключ. Випуск нового ключа автоматично анулює попередній. Це запобігає розбіжності токенів, коли ви змінюєте облікові дані в різних середовищах.

Ендпоінт Chat Completions

Надсилайте текстові запити до /v1/chat/completions ендпоінт, що використовує ідентифікатор моделі uncensored. API приймає стандартні повідомлення чату та повертає текстові відповіді без фільтрів контенту для законного дорослого використання. Ви можете налаштувати такі параметри, як temperature, top_p, а також stop для контролю креативності та довжини виводу.

Вікно контексту дозволяє до 100 000 токенів для поєднаного промпту та відповіді. Встановіть max_tokens для контролю виводу, зі значенням за замовчуванням 2 048 токенів, якщо не вказано. Помилки та відмови не споживають кредит, тому ви можете безпечно тестувати.

Потокові відповіді та використання

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає Server-Sent Events (SSE), що містять часткові текстові чанки. Дані про використання токенів з'являються лише у фінальному чанку потоку. Це дозволяє відображати відповіді в реальному часі та точно відстежувати споживання.

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

Function Calling та інструменти

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

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

Режим JSON та параметри

Примусовий структурований вивід шляхом встановлення response_format до {"type": "json_object"}. Модель повертатиме валідний JSON замість звичайного тексту. Це корисно для витягування даних або генерації конфігурацій. Поєднуйте це з викликом функцій для надійних API-інтеграцій.

Інші підтримувані параметри включають seed для детермінованих результатів, presence_penalty, а також frequency_penalty. Використовуйте seed для відтворення конкретних відповідей під час налагодження. Налаштуйте штрафи, щоб зменшити повторення або стимулювати різноманітність словникового запасу у ваших результатах.

Обробка помилок та обмеження

API встановлює ліміт швидкості у 300 запитів на хвилину та 8 одночасних запитів на ключ. Тіла запитів не повинні перевищувати 8 МБ. Якщо ви перевищите ці ліміти, ви отримаєте код статусу 429. Помилки автентифікації повертають помилку 401. Недостатній кредит викликає помилку 402.

Кредит нараховується на основі реального використання токенів. Передоплачений кредит ніколи не закінчується, тому вам не потрібно турбуватися про щомісячне поновлення. Використовуйте сторінку Підтримки для вирішення таких проблем, як подвійне списання.

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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