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

Базова URL-адреса та аутентифікація

Базовий URL для всіх запитів — HTTPS://api.aiobliterated.com/v1. Для автентифікації потрібен API-ключ. Згенеруйте його, зареєструвавшись через Google або електронну пошту з паролем на сторінці отримання API-ключа. Передавайте ключ у заголовку Authorization як Bearer токен. Кожен запит вимагає цей заголовок для ідентифікації вашого облікового запису та відстеження використання.

Copycurl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

Ваш перший запит

Надішліть POST-запит до /v1/chat/completions для генерації тексту. Встановіть модель на "uncensored" і додайте свій системний промпт. API повертає відповідь моделі у полі content. Це стандартний формат, який використовують більшість клієнтів LLM.

Copyfrom openai import OpenAI

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

Використання Node SDK

Встановіть офіційний SDK OpenAI для Node.js. Налаштуйте його з вашим ключем API та базовою URL-адресою. Викличте метод chat.completions.create з повідомленнями. SDK автоматично обробляє серіалізацію та потокове передавання.

Copyimport OpenAI from "openai";

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

Потокові відповіді

Увімкніть потокову передачу, встановивши stream у true у своєму запиті. API повертає потік подій, наданих сервером (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)

Контекстне вікно та ліміти

Модель підтримує контекстне вікно розміром 100,000 токенів. Воно включає як запит, так і відповідь. Ви можете встановити максимальний обсяг виводу на рівні 16,000 токенів за запит. Якщо ви не вкажете max_tokens, ліміт становитиме 2,048 токенів. Це забезпечує передбачувані витрати та продуктивність.

Обробка помилок та обмеження

Моніторьте коди стану HTTP для виявлення помилок. Відповідь 401 означає, що ваш API-ключ недійсний. Відповідь 402 вказує на недостатність кредитів. Відповідь 429 сигналізує про перевищення ліміту швидкості, який становить 300 запитів на хвилину. Обробляйте ці помилки коректно у вашій програмі для забезпечення надійності.