Швидкий старт API

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

Почніть з того, щоб вказати клієнту на нашу базову URL-адресу та передати свій ключ у заголовку. Ми використовуємо стандартний механізм Authorization, тому будь-який SDK OpenAI або сумісний клієнт працює одразу. Вам не потрібно керувати складними потоками OAuth або чекати схвалення. Просто зареєструйтеся через Google або електронну пошту, скопіюйте ключ, і ви готові до роботи. Кінцева точка знаходиться за адресою https://api.aiohnezensur.com/v1 та приймає Authorization: Bearer YOUR_API_KEY header на кожному запиті.

Надсилання першого запиту

Зробіть простий запит на завершення чату для тестування моделі uncensored. Цей запит надсилає промпт і отримує текстову відповідь без звичайних корпоративних обмежень. Ви можете використовувати будь-який інструмент, що підтримує протокол OpenAI, але прямий виклик curl показує, що відбувається всередині. Замініть YOUR_API_KEY з вашим реальним ключем з панелі керування.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Відповідь включає згенерований текст та статистику використання токенів. Якщо ви отримуєте відповідь, ваша інтеграція працює правильно. Тепер ви можете перейти до створення більш складних взаємодій або перемикання на програмні клієнти.

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

Використовуйте офіційний пакет OpenAI для Python для бездоганної взаємодії з нашим API. Встановіть базовий URL на наш ендпоінт і надайте свій ключ як API-токен. Це дозволяє вам використовувати існуючі кодові бази без переписування логіки HTTP. ID моделі uncensored, що запускає нашу конкретну велику мовну модель, налаштовану для виводу без обмежень.

Copyfrom openai import OpenAI

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

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

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

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

Copyimport OpenAI from "openai";

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

Запустіть цей код, щоб побачити, як модель реагує на ваш вхід. Ви можете швидко ітерувати, змінюючи вміст промпту. Структура відповіді відповідає стандартному формату OpenAI, що забезпечу сумісність з іншими інструментами у вашому стеку.

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

Увімкніть потокову передачу, щоб отримувати токени по мірі їх генерації, що зменшує сприйняту затримку. Це критично важливо для інтерфейсів, які відображають текст у реальному часі. Встановіть stream параметр на true у вашому запиті. API надсилає серію подій, надісланих сервером (SSE), замість одного об'єкта JSON. Кожен фрагмент містить часткову дельту відповіді.

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 МБ. Якщо ви перевищите ці ліміти, API повертає код стану 429. Вам слід реалізувати експоненційне уповільнення в клієнті, щоб плавно обробляти ці піки. Вікно контексту становить 100 000 токенів загалом, з максимальним виводом 16 000 токенів за запит. Помилки та відмови не споживають кредит, тому ви можете безпечно повторювати спроби. Помилки автентифікації повертають 401, а недостатній баланс — 402.