Посібник з інтеграції API Character AI

Чому варто замінити Character AI на API?

Character AI зручний, але він блокує ваших персонажів у своїй екосистемі. Ви не можете зберегти повне вікно контексту, налаштувати параметри моделі або гарантувати приватність ваших даних. Рішення на основі API, таке як uncutly AI дає вам прямий доступ до необмеженої LLM. Ви контролюєте промпти, температуру та послідовності зупинки. Це означає, що ваші персонажі поводяться саме так, як ви хочете.

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

Крок 1: Отримайте свій API-ключ

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

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

Крок 2: Налаштуйте базову URL-адресу

Більшість сучасних клієнтів LLM очікують інтерфейс, сумісний з OpenAI. Вам потрібно вказати правильний базовий URL для вашого SDK. Для цієї послуги кінцева точка має вигляд https://api.uncutlyai.com/v1. Ця структура URL-адреси відображає стандартний API OpenAI. Це означає, що ви можете використовувати існуючі бібліотеки без значних змін у коді.

Оновіть об'єкт конфігурації, щоб включити цей базовий URL. Також встановіть API-ключ у заголовку авторизації. Ідентифікатор моделі, який ви будете використовувати, просто "uncensored". Ця модель налаштована на меншу кількість відмов та кращу творчу свободу. Вона добре працює з довгими контекстами до 100,000 токенів. Ця довжина дозволяє зберігати глибокі історії персонажів.

Крок 3: Надішліть свій перший запит на завершення чату

Створіть запит до /v1/chat/completions endpoint. endpoint. Тіло запиту має містити список повідомлень. Кожне повідомлення має роль, таку як "system", "user" або "assistant". Системне повідомлення визначає особистість персонажа. Повідомлення користувача керують розмовою.

Ось як ви структуруєте запит:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

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

Крок 4: Обробляйте потокові відповіді

Чат-додатки відчуваються повільними, якщо весь відповідь чекає до кінця. Стримінг вирішує цю проблему. Встановіть stream параметр на true. Сервер повертає серію подій Server-Sent Events (SSE). Кожна подія містить невеликий чанк тексту.

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

Copyfrom openai import OpenAI

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

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

Крок 5: Управління токенами та витратами

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

Ця передоплачена модель прозора. Ви поповнюєте рахунок криптовалютою. Мінімальна сума поповнення — $20. Ви можете додавати по $500 за раз. Немає щомісячних підписок. Ваш кредитний баланс ніколи не прострочується. Ця передбачуваність допомагає планувати витрати на розробку. Ви точно знаєте, скільки коштуватиме кожна розмова.

Крок 6: Реалізація виклику функцій

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

Наприклад, персонажу може знадобитися перевірити погоду. Ви надсилаєте визначення функції в запиті. Модель відповідає об’єктом JSON із назвою функції та аргументами. Ваш код виконує функцію та надсилає результат назад моделі.

Copyimport OpenAI from "openai";

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

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

Крок 7: Обробка помилок та лімітів

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

Обробляйте помилки мережі коректно. Якщо сервер повертає помилку 500, зачекайте та повторіть спробу. Ніколи не припускайте, що модель завжди буде успішною. Логуйте ці помилки, щоб виявляти закономірності. Часті таймаути можуть вказувати на необхідність налаштування часу очікування.

Крок 8: Масштабування вашої інтеграції

Оскільки ваша база користувачів зростає, ваше використання API зростатиме. Уважно відстежуйте споживання токенів. Використовуйте дані про використання з потокових відповідей для відстеження витрат. Якщо ви помітите високі витрати, спробуйте оптимізувати свої підказки. Короткі системні підказки можуть зменшити вхідні токени.

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