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

Аутентифікація та базовий URL

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

Copycurl https://api.bestabliteratedmodels.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 endpoints with zero refusals for uncensored chat"}]
  }'

Зберігайте ваш ключ у безпеці. Кожен обліковий запис дозволяє один активний ключ одночасно. Якщо ви згенеруєте новий, попередній ключ перестає працювати миттєво. Це гарантує, що ваше використання завжди прив’язане до одного облікового запису.

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

Зробіть базовий запит на завершення чату для тестування кінцевої точки. Використовуйте ідентифікатор моделі 'uncensored', щоб отримати вивід без відмов у вмісті. API приймає стандартні параметри, такі як temperature та top_p. Ви можете надіслати простий промпт, щоб перевірити, чи працює з’єднання коректно.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.bestabliteratedmodels.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 токенів. Це включає як ваш вхідний запит, так і вихідні дані. Помилки, такі як некоректні ключі, повертають код статусу 401.

Інтеграція Node SDK

Інтегруйте API у свої застосунки Node.js за допомогою офіційного SDK. Налаштуйте клієнта з вашим базовим URL і API-ключем. Структура коду відображає стандартні реалізації OpenAI. Це полегшує міграцію з інших постачальників.

Copyimport OpenAI from "openai";

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

Обробляйте дані відповіді, щоб витягти завершення. API підтримує виклик функцій та режим JSON. Ви можете примусово встановлювати суворі виводи JSON, встановивши параметр response_format. Це корисно для побудови конвеєрів структурованих даних.

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

Увімкніть потокову передачу, щоб отримувати токени по мірі їх генерації. Це зменшує сприйняту затримку для користувачів. 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)

Останній фрагмент у потоці містить загальне використання токенів. Це дозволяє точно відстежувати витрати. Потокова передача працює з усіма параметрами, такими як температура та послідовності зупинки. Використовуйте її для чат-інтерфейсів, які вимагають оновлень у реальному часі.

Ліміти частоти та помилки

Моніторьте обсяг запитів, щоб уникнути переривань. Ліміт становить 300 запитів на хвилину на ключ. Ви також можете виконувати 8 одночасних запитів одночасно. Розмір тіла запиту не може перевищувати 8 МБ. Перевищення цих лімітів повертає код стану 429.

Якщо у вас закінчаться кошти, API поверне помилку 402. Ви можете поповнити баланс за допомогою криптовалюти. Ми приймаємо USDT на TRC20 або USDC на Base. Мінімальна сума поповнення становить $20. Бонуси застосовуються для більших сум. Помилки, такі як недійсні ключі, повертають 401.

Контекстне вікно та обмеження

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

API працює лише з текстом. Ми не пропонуємо вбудовування (embeddings) або генерацію зображень. Відмови в контенті рідкісні, але застосовуються до контенту сексуального характеру з участю неповнолітніх. Це тверде обмеження забезпечує відповідність вимогам. Використовуйте API для законного дорослого контенту, художньої літератури або досліджень.