Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Базовый URL — https://api.apertusia.com/v1. Передайте свой API-ключ в заголовке Authorization. Идентификатор модели — uncensored. Эта конфигурация работает с любым клиентом, совместимым с OpenAI.

Используйте эту команду cURL для немедленной проверки подключения. Замените YOUR_API_KEY на ваш фактический ключ.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

Ошибки аутентификации возвращают 401. Недостаточно средств — 402. Превышение лимитов запросов — 429.

2. Поддерживаемые параметры: Temperature, Top P и Seed

Управляйте случайностью с помощью temperature, разнообразием — top_p, а воспроизводимостью — seed. Эти параметры соответствуют стандартным соглашениям OpenAI. Установите temperature на 0.7 для сбалансированного результата или на 1.0 для большей креативности. Используйте top_p, чтобы ограничить выборку верхней границей вероятностной массы. Параметр seed гарантирует идентичные результаты при отладке.

Пример фрагмента кода на Python для локального тестирования:

Copyfrom openai import OpenAI

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

3. Потоковые ответы с использованием Server-Sent Events

Включите потоковую передачу, установив stream: true. API возвращает данные через Server-Sent Events. Каждый фрагмент содержит частичный текст и данные об использовании токенов. Это снижает воспринимаемую задержку при длинных ответах. Обрабатывайте события SSE для обновления вашего интерфейса в реальном времени.

Пример на Node.js с использованием официального SDK:

Copyimport OpenAI from "openai";

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

4. Настройка вызова функций и режима JSON

Используйте response_format с {"type": "json_object"} для строгого вывода JSON. Это обеспечивает структурированные данные для программных конвейеров. Включите вызов функций, предоставив массив tools в теле запроса. Модель вернет вызовы инструментов в ожидаемом формате. Используйте tool_choice, чтобы принудительно задать определенное поведение.

5. Лимиты частоты запросов и ограничения размера запроса

Каждый API-ключ поддерживает 300 запросов в минуту. Одновременные запросы ограничены 8 на ключ. Максимальный размер тела запроса — 8 МБ. Контекстное окно вмещает 100,000 токенов в общей сложности. Максимальный объем вывода на запрос — до полного 100,000-токенного окна. Оставьте max_tokens без значения или установите его на высокий уровень, чтобы избежать усечения. Ошибки не списывают кредит. Возвраты не производятся, но ошибки в биллинге исправляются через поддержку.

6. Аутентификация и обработка ошибок

Создайте ключ через панель управления. Используйте вход через Google или email. Ключ появится сразу. Добавьте его в заголовок Authorization: Bearer. Неверные ключи возвращают 401. Ошибки 429 указывают на исчерпание лимита запросов. Ошибки 402 означают, что ваш предоплаченный баланс исчерпан. Пополните баланс с помощью USDT или USDC. Кредиты никогда не истекают.

Потоковая передача

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)