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

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

Автентифікація кожного запиту шляхом передачі вашого API-ключа в Authorization header. Наш сервіс використовує єдину базову URL-адресу для всіх операцій, що дозволяє вам перейти від інших постачальників без зміни основної логіки. Просто замініть типову базову URL-адресу в конфігурації вашого клієнта на https://api.abliteratedgemma.com/v1 і вставте свій ключ. Це працює з будь-яким стандартним OpenAI-сумісним SDK, дозволяючи використовувати той самий клієнтський код для нашої uncensored моделі, що й для комерційних гігантів.

Зроблення першого запиту

Надішліть POST-запит на /v1/chat/completions за допомогою ідентифікатора моделі uncensored. API приймає стандартні повідомлення чату та повертає текст напряму. Використовуйте наведену нижче команду cURL для перевірки з’єднання та миттєвого отримання відповіді.

Copycurl https://api.abliteratedgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python loop"}]
  }'

Цей ендпоінт підтримує до 100,000 токенів у спільному запиті та відповіді. Якщо ви не вказали ліміт токенів, модель за замовчуванням генерує 2,048 вихідних токенів. Переконайтеся, що ваші запити не перевищують ліміт тіла в 8 МБ, щоб уникнути помилок обрізання.

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

Встановіть офіційний пакет OpenAI Python і налаштуйте його на вказівник на нашу базову URL-адресу. Це дозволяє використовувати знайомі методи, як-от chat.completions.create для синхронних запитів. Наступний приклад демонструє, як ініціалізувати клієнта та надіслати простий промпт до uncensored моделі.

Copyfrom openai import OpenAI

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

Запам’ятайте, що помилки, такі як 401, вказують на недійсний ключ, тоді як 402 означає, що ваш передоплачений кредит вичерпано. Оскільки ми не пропонуємо підписки, вам потрібно поповнити баланс через крипто, щоб продовжити використання сервісу.

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

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

Copyimport OpenAI from "openai";

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

SDK Node автоматично обробляє серіалізацію запитів, але ви все одно повинні керувати власним балансом кредитів. Перевірте сторінку ціноутворення, щоб дізнатися поточні тарифи на токени та варіанти поповнення криптовалютою.

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

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає фрагменти тексту по мірі їх генерації, що дозволяє знизити затримку в додатках, орієнтованих на користувача. Використовуйте цей код для обробки потоку токен за токеном.

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)

Потокова передача працює з клієнтами Python та Node. Кожен чанк містить частковий текст, а останній чанк включає загальне використання токенів. Це ідеально підходить для чат-інтерфейсів, де миттєва зворотна зв'язок покращує користувацький досвід.

Ліміти та обробка помилок

Моніторьте ліміти запитів, щоб уникнути переривань. Вам дозволено 300 запитів на хвилину та 8 одночасних запитів на ключ. Якщо ви перевищите ліміт швидкості, API поверне помилку 429. Завжди обробляйте помилки 401, перевіривши свій ключ, а помилки 402 — поповнивши крипто-кредит. Наш передоплачений кредит не має строку дії, тому ви можете призупинити використання без втрати коштів.

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

Модель підтримує вікно контексту на 100,000 токенів, що включає як вхідні, так і вихідні токени. Це дозволяє зберігати велику історію розмов або обробляти великі документи за один запит. ID моделі uncensored, і він працює на наших серверах без відмов у вмісті для дорослого контенту. Використовуйте цю можливість для збереження довготривалої пам’яті або ефектної обробки великих наборів даних.