Документация API

Базовый URL и аутентификация

Подключите свое приложение, указав на наш выделенный эндпоинт и передав ваш уникальный ключ API. Базовый URL для всех запросов: https://api.apertusapp.com/v1. Вы получаете свой ключ сразу после регистрации через Google или email на Получить API-ключ странице. Включите этот ключ в Authorization header для каждого запроса.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Каждый аккаунт генерирует один активный ключ. Если вы сгенерируете новый ключ, предыдущий становится недействительным мгновенно. Это обеспечивает строгий контроль над вашим доступом без подписок или простоев.

Первый запрос

Отправьте первый запрос в конечный пункт chat completions для получения сырого, нефильтрованного текста. Используйте идентификатор модели uncensored для доступа к нашей конкретной open-weight модели, настроенной на законное взрослое и спорное содержание.

Copyfrom openai import OpenAI

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

API принимает стандартные параметры, такие как temperature и top_p. Ошибки и отказы не потребляют токены, поэтому вы платите только за то, что фактически достигает модели. Этот подход поддерживает предсказуемые расходы по сравнению с агрегаторами, которые взимают плату за накладные расходы маршрутизации.

Интеграция Node SDK

Используйте официальный Node SDK для эффективной работы с JSON-режимом и вызовом функций. Установите response_format для {"type": "json_object"} для структурированных выводов или определите инструменты для поведения, подобного агенту.

Copyimport OpenAI from "openai";

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

Модель поддерживает вызовы инструментов с tool_choice варианты. Вы также можете установить seed для детерминированных результатов. Эта гибкость позволяет создавать сложные приложения, не выходя из экосистемы, совместимой с OpenAI.

Потоковые ответы

Передавайте токены в реальном времени с использованием Server-Sent Events (SSE) для пользовательского опыта с низкой задержкой. Каждый блок содержит сгенерированный текст, а последний блок включает статистику общего использования токенов.

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 автоматически обрабатывает протокол SSE, требуя минимального кода с вашей стороны.

Контекстное окно и емкость

Модель поддерживает контекстное окно объёмом 100,000 токенов для суммарного ввода и вывода. Вы можете указать до 16,000 токенов на запрос или использовать 2,048 токенов, если не укажете max_tokens.

Это большое окно позволяет проводить обширный анализ документов или хранить длинные истории разговоров. Однако держите тела запросов в пределах 8 МБ. Модель — это не GPT или Llama; это отдельная нецензурная ИИ-модель, оптимизированная под ваши конкретные задачи.

Обработка ошибок и лимиты

Грамотно обрабатывайте стандартные ошибки HTTP для поддержания надежного потока приложения. A 401 ошибка указывает на недействительный или отсутствующий API-ключ. A 402 ошибка означает, что исчерпан предоплаченный кредит. A 429 ошибка сигнализирует о том, что вы превысили лимит в 300 запросов в минуту или 8 одновременных запросов.

Кредит не сгорает, поэтому вы можете приостановить использование и возобновить его позже. Ошибки, такие как двойные списания, исправляются через страницу поддержки. Предоплаченный кредит начисляется только за фактивное потребление токенов, обеспечивая прозрачное ценообразование за каждый байт.