Документація API & Швидкий старт

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

Почніть кожен запит, звернувши ваш клієнт до HTTPS://api.uncensoredia.com/v1 та прикріплення вашого ключа. Авторизація використовує стандартний Bearer схему, тому вам просто потрібно вставити токен, отриманий після реєстрації через Google або електронну пошту. Кінцева точка повністю API OpenAI сумісний відповідний, що означає, що вам потрібно лише замінити базовий URL та API-ключ у існуючій конфігурації. Вам не потрібно керувати складними шарами маршрутизації або заголовками проксі. Просто переконайтеся, що ваш Authorization header містить ваш унікальний токен. Ця конфігурація гарантує, що ваші запити надходять до виділеної необмеженої моделі без жодного проміжного фільтрування. Якщо ви отримуєте 401 помилку, переконайтеся, що ваш ключ активний і правильно відформатований.

Ендпоінт Chat Completions

Надсилайте повідомлення до POST /v1/chat/completions отримувати текстові відповіді від uncensored моделі. Цей єдиний ендпоінт обробляє всі ваші потреби в генерації, від простих промптів до складних багатосторонніх розмов. Ви можете контролювати довжину виводу та випадковість за допомогою таких параметрів, як max_tokens, temperature, а також top_p. Модель підтримує масивне 100 000 токенів вікно контексту, дозволяючи завантажувати обширну документацію або довгі історії розмов. Ви можете надіслати до 16,000 токенів у відповіді. Якщо ви пропустите max_tokens, ліміт за замовчуванням становить 2048 токенів. Цей ендпоінт не підтримує генерацію зображень або аудіо. Це суто текстовий API: текст на вхід, текст на вихід. Використовуйте наведену нижче команду curl, щоб негайно протестувати своє з'єднання.

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

Використовуйте офіційну Python-бібліотеку OpenAI для взаємодії з API з мінімальними змінами в коді. Вам потрібно лише перевизначити base_url та api_key у конфігурації клієнта. Цей підхід гарантує, що ваша існуюча логіка обробки відповідей, помилок та повторних спроб залишиться незмінною. Бібліотека автоматично обробляє серіалізацію JSON та потокову передачу, якщо ви її увімкнете. Цей метод ідеально підходить для бекенд-сервісів або скриптів, яким потрібно обробляти великі обсяги тексту. uncensored модель відповідає на стандартні запити завершення чату без необхідності користувацької логіки парсингу. Налаштуйте свій клієнт один раз і використовуйте його протягом усього додатка. Ось як ініціалізувати клієнт та надіслати базовий запит.

Налаштування SDK Node.js

Інтегруйте API у свої застосунки JavaScript або TypeScript, використовуючи @anthropic-ai/sdk або офіційний openai пакет. Встановіть baseURL до нашого ендпоінту та надайте свій API-ключ. Це дозволяє вам використовувати знайомі методи, такі як chat.completions.create() безпосередньо. SDK обробляє HTTP-запити та парсить JSON-відповіді за вас. Ви можете легко обробляти помилки, наприклад 402 (недостатньо кредиту) або 429 (ліміт швидкості) всередині вашої логіки програми. Ця конфігурація ідеально підходить для веб-серверів, ботів або будь-якого середовища Node.js. Нецензурована модель бездоганно працює зі стандартним форматом запиту. Налаштуйте свій клієнт, щоб забезпечити сумісність з очікуваннями API.

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

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

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

API встановлює суворі ліміти для забезпечення стабільної продуктивності для всіх користувачів. Ви можете надсилати до 300 запитів за хвилину per key and have 8 одночасних запитів активний у будь-який час. Максимальний розмір тіла запиту становить 8 МБ. Якщо ви перевищите ці ліміти, ви отримаєте 429 код статусу. Переконайтеся, що обробляєте повторні спроби з експоненційним затриманням, щоб уникнути повторного перевищення цих лімітів. Контекстне вікно становить 100,000 токенів, але максимальний обсяг виходу — 16,000 токенів. Якщо вам потрібно більше виходу, змініть max_tokens параметр. Помилки, такі як 401 (недійсний ключ) та 402 (немає кредиту) є миттєвими і не споживають ваш ліміт токенів. Управляйте своєю квотою обережно, щоб уникнути перерв у службі під час завдань масової генерації.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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