Быстрый старт: Подключение чата apertus ai

Предварительные требования и настройка

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

Настройте переменную окружения или клиент SDK, указав правильный базовый URL. Этот URL работает со стандартными библиотеками OpenAI. Измените только базовый URL и ключ. Идентификатор модели — "uncensored". Этот единственный эндпоинт обрабатывает все текстовые завершения. Вам не нужно управлять маршрутизацией или выбирать разные модели.

Убедитесь, что библиотека вашего клиента поддерживает протокол OpenAI Chat Completions. Большинство современных 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. Включите идентификатор модели "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 ограничивают длину вывода. По умолчанию используется значение 2 048 токенов. Установите более высокое значение при необходимости. Жесткий лимит на запрос составляет 16 000 токенов. Контекстное окно составляет 100 000 токенов. Планируйте длину истории соответствующим образом. Штрафы за частоту и наличие помогают уменьшить повторения.

Понимание ограничений и ошибок

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

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

Управление контекстным окном критически важно. Суммируйте токены промпта и завершения. Держитесь значительно ниже 100,000 токенов. При необходимости обрезайте старые сообщения. API не выполняет автоматическую обрезку. Вы контролируете длину истории. Эффективное использование контекста снижает затраты.