Документація API для розробників

Базова URL-адреса та аутентифікація

Підключіться до нашої інфраструктури, вказавши вашому клієнту призначений базовий URL та надавши ваш унікальний API-ключ. Ми використовуємо стандартну автентифікацію через заголовки, тому ви можете підставити наш ендпоінт у існуючі конфігурації SDK OpenAI без переписування основної логіки. Ви отримуєте один активний ключ на обліковий запис, і генерація нового ключа миттєво анулює попередній. Цей дизайн робить вашу інтеграцію простою, одночасно забезпечуючи чіткий контроль доступу. Зареєструйтеся через Google або електронну пошту, щоб миттєво побачити свій ключ. Нам не потрібен номер телефону або метод оплати для початку.

• Базовий URL: https://api.uncensoreai.com/v1
• Заголовок Auth: Authorization: Bearer YOUR_API_KEY

Перший запит (POST /v1/chat/completions)

Надішліть своє перше завершення, надіславши набір даних JSON на ендпоінт завершення чату. Ідентифікатор моделі — uncensored і приймає стандартні структури повідомлень із ролями system, user та assistant. Ви отримуєте миттєвий текстовий вивід без складного маршрутизування чи логіки вибору моделі. Помилки не споживають ваші передоплачені кредити, тому ви можете тестувати без обмежень. Модель обробляє генерацію з відкритими вагами, налаштовану для дорослого контенту без відмов. Використовуйте цю структуру, щоб розпочати інтеграцію.

Інтеграція SDK Python

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

Інтеграція SDK Node.js

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

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

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

Ліміти, помилки та контекстне вікно

Ваш акаунт має контекстне вікно на 100,000 токенів для промпту та завершення разом. Ви можете надіслати до 16,000 токенів в одній відповіді, якщо вкажете max_tokens. Стандартний ліміт виходу — 2,048 токенів, якщо ви пропустите цей параметр. Ліміти швидкості дозволяють 300 запитів на хвилину та 8 одночасних запитів на ключ. Статус 401 означає, що ваш ключ недійсний. Статус 402 вказує на недостатній попередньо оплачений кредит. Статус 429 означає, що ви перевищили ліміт швидкості. Тіла запитів не можуть перевищувати 8 МБ.

cURL

Copycurl https://api.uncensoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the current server status from the api endpoint"}]
  }'

Python

Copyfrom openai import OpenAI

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