Покрокова інтеграція API LLM uncensored.com

Передумови: SDK та налаштування середовища

Встановіть бажаний SDK для вашої мови, щоб спілкуватися з кінцевою точкою. Більшість розробників використовують офіційний SDK OpenAI для Python, Node.js або Go. Це працює, тому що API відповідає стандартній схемі chat completions OpenAI.

Переконайтеся, що ваше середовище має Python 3.8+ або Node.js 18+. Встановіть пакет через pip або npm. Вам знадобиться API-ключ з панелі керування. Для реєстрації не потрібен номер телефону.

• Python: pip install openai
• Node.js: npm install openai

Збережіть ваш API-ключ у змінній середовища. Це запобігає випадковому розголошенню в системі контролю версій. Ключ надає доступ до uncensored моделі.

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

Направте клієнт SDK на правильну базову URL-адресу. Це найважливіший крок для успішної інтеграції. Стандартна базова URL-адреса OpenAI не працюватиме для цього сервісу.

Вкажіть базовий URL на HTTPS://api.uncensoredaicom.com/v1. Це спрямовує запити до інфраструктури uncensored LLM. Ідентифікатор моделі, який ви повинні надіслати, — "uncensored". Це модель з відкритими вагами, налаштована на мінімальні відмови.

Перевірте з'єднання, викликавши кінцеву точку models. Це підтверджує, що ваші облікові дані та базовий URL правильні. Успішна відповідь повертає id моделі та тип об'єкта.

Налаштування автентифікації та заголовків

Передавайте свій API-ключ у заголовку Authorization. Використовуйте схему Bearer для всіх запитів. Цей заголовок автентифікує ваш акаунт із передоплаченим кредитом.

Встановіть заголовок як: Authorization: Bearer YOUR_API_KEY. SDK обробляє це автоматично, якщо ви передасте ключ у конструктор клієнта. Переконайтеся, що немає зайвих пробілів. Невірні ключі повертають помилку 401 Unauthorized.

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

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

Надішліть POST-запит на /v1/chat/completions. Надішліть свої повідомлення як масив об’єктів role та content. Система підтримує ролі user, assistant та system.

Приклад структури: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API повертає завершення тексту. Розмір контекстного вікна становить 100,000 токенів загалом. Максимальний обсяг виходу — 16,000 токенів за запит.

Помилки та відмови не споживають кредит. Це захищає ваш баланс передоплати. Встановіть temperature та top_p для контролю. Значення за замовчуванням підходять для більшості випадків використання.

Увімкнення потокової передачі для виводу в реальному часі

Встановити stream: true у тілі вашого запиту. Це активує події, надіслані сервером (SSE). Токени надходять поступово, а не чекаючи повного завершення.

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

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

Використання Tools та Function Calling

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

Вказати tool_choice для контролю вибору функції. Використовуйте auto для автоматичного виявлення. API підтримує стандартні визначення інструментів. Розпарсуйте аргументи виклику функції з відповіді.

Реалізуйте виконання функції у своєму коді. Надішліть результат назад як повідомлення. Модель продовжує розмову. Це дозволяє складні робочі процеси. Тестування забезпечує точне парсингу аргументів.

Відповіді в режимі JSON

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

Парсуйте рядок JSON у своєму коді. Обробляйте можливі помилки парсингу. Режим JSON підвищує надійність для інтеграцій API. Він ідеально підходить для конвеєрів обробки даних.

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

Моніторинг лімітів та помилок

Дотримуйтесь лімітів швидкості. Вам доступно 300 запитів на хвилину на ключ. Максимум 8 паралельних запитів. Розмір тіла запку обмежено 8 МБ.

Моніторьте коди стану HTTP. 429 вказує на перевищення ліміту швидкості. 400 вказує на неправильний запит. 500 вказує на помилку сервера. Реалізуйте експоненційне сповільнення для повторних спроб. Це запобігає перевантаженню API.

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

Розрахунок витрат та використання токенів

Ціноутворення прозоре та передоплачене. Вхідні токени коштують $0.15 за мільйон. Вихідні токени коштують $0.50 за мільйон. Кредит ніколи не прострочується. Платежі за підписку не стягуються.

Поповнюйте рахунок лише криптою. USDT (TRC20) або USDC (Base). Суми варіюються від $20 до $500. Бонусний кредит застосовується за більші поповнення. +5% від $50, +10% від $100, +15% від $200.

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