Швидкий старт: Інтегруйте чат apertus ai

Передумови та налаштування

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

Налаштуйте змінну середовища або клієнт SDK, щоб вказати на правильний базовий URL. Цей URL працює зі стандартними бібліотеками OpenAI. Змініть лише базовий URL та ваш ключ. Ідентифікатор моделі — "uncensored". Ця єдина кінцева точка обробляє всі текстові завершення. Вам не потрібно керувати маршрутизацією або обирати різні моделі.

Переконайтеся, що ваша бібліотека клієнта підтримує протокол Chat Completions OpenAI. Більшість сучасних SDK працюють із коробки. Переконайтеся, що ваша мережа дозволяє вихідні HTTPS-запити. Сервіс приймає стандартні JSON-посилання. Ніяких спеціальних заголовків не потрібно, крім автентифікації.

Аутентифікація за допомогою API-ключів

Передавайте свій API-ключ у заголовку Authorization для кожного запиту. Використовуйте схему Bearer, за якою йде рядок вашого ключа. Сервіс перевіряє ключ на відповідність вашому акаунту. Неправильні ключі повертають помилку 401 Unauthorized. Прострочені або недостатні кошти викликають відповідь 402 Payment Required. Перевірте свій баланс на панелі керування, якщо запити не вдаються.

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

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

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

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

Відправте POST-запит до кінцевої точки chat completions. Вкажіть ID моделі "uncensored" та історію ваших повідомлень. API повертає текстову відповідь. Ви можете отримувати вивід у потоковому режимі або чекати повного завершення. Кожен запит споживає токени вводу та виводу. Помилки не нараховують кредити. Відмови є безкоштовними.

Copyfrom openai import OpenAI

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

У відповіді міститься статистика використання. Відстежуйте споживання токенів, щоб керувати своїм попередньо оплаченим кредитом. Модель відповідає без відмов у вмісті для законного дорослого використання. Ви можете надсилати системні промпти для визначення поведінки. Повідомлення користувача керують розмовою. Контекстне вікно підтримує загальну кількість 100,000 токенів.

Почніть з простого двох повідомлень. Це перевіряє з’єднання та якість відповіді. Налаштуйте temperature та top_p для креативних або точних виводів. API підтримує стандартні параметри. Послідовності зупинки працюють як очікується. Значення seed забезпечують відтворювані результати.

Потокові відповіді через SSE

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

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 не надсилає історію знову. Почніть новий запит, якщо потік зламався. Кількість токенів у останньому чанку відображає всю генерацію.

Обробка параметрів і режимів

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

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

Copyimport OpenAI from "openai";

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

Ліміт max tokens обмежує довжину виводу. Типове значення становить 2 048 токенів. Встановіть вище значення за потреби. Жорсткий ліміт за запит — 16 000 токенів. Контекстне вікно становить 100 000 токенів. Плануйте довжину історії відповідним чином. Штрафи за частоту та наявність допомагають зменшити повторення.

Розуміння обмежень та помилок

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

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

Керування контекстним вікном є критично важливим. Сумуйте токени запиту та відповіді. Тримайтеся значно нижче 100,000 токенів. Обрізайте старі повідомлення за потреби. API не виконує автоматичне обрізання. Ви контролюєте довжину історії. Ефективне використання контексту знижує витрати.