Нецензурований ШІ: Покроковий посібник з інтеграції

Чому незалежний AI-чат важливий для розробників

Розробники, які створюють застосунки для рольових ігор, часто стикаються з непомітними відмовами, що руйнують занурення користувача. Стандартні моделі часто погіршують якість контенту або блокують запити на основі розмитих «вібраційних» перевірок, а не чітких порушень політики. Рішення для чату з необмеженим ШІ усуває цих довільних цензорів, дозволяючи вашому застосунку обробляти різноманітні, дорослі або суперечливі теми без постійного тертя. Ця надійність критично важлива для конвеєрів контенту, де консистентність важливіша за загальну безпеку.

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

Налаштування вашого середовища

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

Встановіть бібліотеку за допомогою менеджера пакетів. Для Python використовуйте pip install openai. Для Node.js використовуйте npm install openai. Після встановлення імпортуйте клієнт і ініціалізуйте його з вашою базовою URL-адресою. Цей крок гарантує, що всі подальші запити правильно маршрутизуються наші сервери. Зберігайте свій ключ у таємниці й ніколи не викладайте його в клієнтському коді, якщо ви не використовуєте проксі.

Налаштування базового URL

Направте свій клієнт на HTTPS://api.storyunfiltered.com/v1, щоб отримати доступ до кінцевої точки без цензури. Ця базова URL-адреса замінює типову кінцеву точку OpenAI у конфігурації вашого SDK. Змінивши цю змінну, ви перемикаєте свою програму зі стандартних моделей GPT на нашу спеціалізовану велику мовну модель без цензури. Ідентифікатор моделі, який ви повинні вказати в своїх запитах, — "uncensored". Цей ідентифікатор повідомляє серверу, до якого конкретного екземпляра маршрутизувати ваш трафік.

Перевірте конфігурацію, надіславши простий тестовий запит. Перевірте кінцеву точку GET /v1/models, щоб підтвердити доступність моделі. У відповіді має бути зазначено "uncensored" як доступну модель. Цей крок перевірки гарантує, що ваше середовище правильно підключено, перш ніж ви почнете розробляти складні функції. Це також підтверджує, що згенерований вами API-ключ активний і пов'язаний з вашим передоплаченим кредитом.

Автентифікація вашим API-ключем

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

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

Надсилання першого запиту

Створіть стандартний POST-запит до /v1/chat/completions із встановленою моделлю "uncensored". Включіть свій системний пропт, щоб визначити персону, та додайте повідомлення користувача, щоб керувати розмовою. Контекстне вікно підтримує 100,000 токенів як для запиту, так і для відповіді разом. Це дозволяє передавати великі документи або довгі історії розмов без миттєвого обрізання. Переконайтеся, що ваше тіло запиту не перевищує 8 MB.

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

Обробка потокових відповідей

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

Останній фрагмент у потоці включає дані про використання токенів. Використовуйте ці дані для точного відстеження споживання вашого кредиту. Ми нараховуємо $0.15 за 1M вхідних токенів та $0.50 за 1M вихідних токенів. Тарифікація базується на реальному використанні, тому часткові відповідні нараховуються пропорційно. Ця прозорість дозволяє впроваджувати контроль витрат безпосередньо в логіку вашого додатка.

Реалізація виклику інструментів

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

Ця функція дозволяє реалізувати складні робочі процеси, такі як пошук погоди, запити до бази даних або парсинг веб-сторінок. Модель без цензури обробляє визначення інструментів із такою ж точністю, що й стандартні моделі. Однак зверніть увагу, що ми не пропонуємо вбудовування (embeddings) чи донавчання. Якщо ваш додаток покладається на пошук за векторами або навчання власних моделей, цей API може не підходити. Для найкращих результатів використовуйте прямі запити chat-completions.

Оптимізація витрат та швидкості

Максимізуйте корисність вашого передоплаченого кредиту, мінімізуючи непотрібні API-запити. Використовуйте параметр seed для детермінованих результатів під час тестування. Відрегулюйте ліміт max_tokens, щоб запобігти надмірно довгим відповідям моделі, які виснажують ваш баланс. Типовий ліміт виводу становить 2 048 токенів, але ви можете збільшити його до 16 000 токенів за запит. Це корисно для генерації довгих історій або детальних звітів за один запит.

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

Вирішення поширених помилок

Якщо ви отримуєте помилку 401, переконайтеся, що ваш API-ключ правильний та активний. Перевірте, чи базовий URL точно відповідає HTTPS://api.storyunfiltered.com/v1. Помилка 404 зазвичай вказує на одрук у шляху кінцевої точки. Переконайтеся, що ви використовуєте правильний HTTP-метод, який є POST для завершення чату. Якщо помилка зберігається, згенеруйте новий ключ у панелі керування.

Помилка 429 означає, що ви перевищили ліміт швидкості у 300 запитів на хвилину. Зачекайте, поки вікно скинеться, або зменшіть частоту запитів. Якщо ви стикаєтеся з помилкою 413, розмір тіла запиту перевищує ліміт у 8 МБ. Спростіть корисне навантаження або зменшіть розмір контекстного вікна. Ці помилки є стандартними для REST API і можуть бути вирішені ретельним налагодженням.