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

Швидкий старт: Підключення в Python або JavaScript

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

Почніть з простого HTTP-запиту для перевірки з’єднання. Використовуйте наведену нижче команду curl, щоб надіслати базовий запит до uncensored модель. Замініть YOUR_API_KEY за допомогою ключа, згенерованого на вашій панелі керування.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

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

Copyfrom openai import OpenAI

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

Користувачі JavaScript можуть досягти того ж результату, використовуючи Node SDK. Встановіть baseURL властивість до нашого ендпоінту. Цей підхід дозволяє інтегрувати API у веб-сервери або бекенд-сервіси з мінімальними змінами в коді.

Copyimport OpenAI from "openai";

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

Управління автентифікацією та API-ключами

Аутентифікація покладається на один API-ключ, переданий у заголовку. Передайте цей ключ в Authorization header для кожного запиту. Якщо ключ відсутній або недійсний, API одразу повертає помилку 401. Це забезпечує безпечний доступ до вашого передоплаченого кредиту.

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

Використовуйте ключ у своїх запитах так: Authorization: Bearer YOUR_API_KEY. Цей стандартний формат заголовка працює з усіма основними SDK. Тримайте ваш ключ під рукою для швидкої ітерації під час розробки.

Параметри ендпоінту Chat Completions

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

Встановити max_tokens щоб обмежити довжину виводу. За замовчуванням 2 048 токенів, якщо не вказано інакше. Модель підтримує вікно контексту в 100 000 токенів для промпту плюс завершення. Це дозволяє довгі розмови без обрізання. Налаштуйте presence_penalty та frequency_penalty щоб зменшити повторення в сценаріях рольових ігор.

Використовуйте stop параметр для зупинки генерації за певними фразами. Це допомагає примусово дотримуватися структури діалогу. The seed параметр забезпечує відтворювані результати для тестування. Ці інструменти надають вам точний контроль над поведінкою моделі.

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

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

Дані про використання з’являються в останньому блоці. Це включає кількість токенів у вхідних і вихідних даних. Перевірте usage field у останньому об’єкті відповіді. Це дозволяє точну перевірку билінгу без окремих викликів API. Відстежуйте споживання токенів у реальному часі.

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

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)

Обробка помилок та ліміти швидкості

API обмежує 300 запитів на хвилину на ключ. Одночасні запити обмежені вісьмома на ключ. Тіло запиту не повинно перевищувати 8 МБ. Перевищення цих лімітів повертає помилку 429. Реалізуйте експоненційне сповільнення для обробки тимчасових сплесків.

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

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

режим JSON та виклик функцій: посібник

Використовуйте режим JSON, встановивши response_format до {"type": "json_object"}. Це змушує модель виводити дійсний JSON. Ідеально підходить для вилучення структурованих даних або відповідей API. Переконайтеся, що ваш запит чітко описує бажану схему.

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

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

Деталі моделі та обмеження вікна контексту

The uncensored модель підтримує контекстне вікно на 100,000 токенів. Це включає як вхідний запит, так і вивід. Максимальний обсяг виводу становить 16,000 токенів за запит. Це дозволяє реалізовувати розгорнуті сценарії рольових ігор без переривання на середині речення.

Модель має відкриті ваги і донавлена для необмеженого контенту. Вона не відмовляє у законних дорослих темах. Це не модель GPT, Claude чи іншого постачальника. Запити обробляються на наших виділених серверах. Це забезпечує стабільну продуктивність та низьку затримку.

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