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 або електронної пошти. Ключ з'явиться миттєво. Додайте його до заголовка 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)