Швидкий старт з API Uncensored ia

Встановлення та налаштування

Встановіть офіційний SDK для бажаної мови. Наш API сумісний з будь-яким стандартним клієнтом OpenAI-compatible, тому ви можете використовувати бібліотеки, яким вже довіряєте. Процес налаштування не вимагає спеціальних налаштувань, окрім додавання залежності до середовища вашого проекту.

Вам потрібен API-ключ для автентифікації ваших запитів. Згенеруйте його одразу після реєстрації через Google або електронну пошту. Ключ з’являється на екрані один раз, тому скопіюйте його в буфер обміну або надійне сховище відразу. Зберігайте його в таємниці, щоб уникнути несанкціонованого використання ваших передоплачених кредитів.

Конфігурація: base_url та ключ

Направте клієнта до базової URL-адреси та встановіть заголовок API-ключа. Використовуйте конкретну кінцеву точку, надану в вашому дашборді. Це гарантує, що ваші запити надходять безпосередньо до моделі uncensored без будь-якої неоднозначності маршрутизації. Базова URL-адреса — HTTPS://api.iasemsensura.com/v1.

Встановіть Authorization header для Bearer YOUR_API_KEY. Цей заголовок автентифікує кожен надісланий вами запит. Без правильного ключа API відхилить ваш ввід із помилкою 401. Завжди перевіряйте, чи відповідає ваш ключ тому, що відображається під час реєстрації.

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

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

Ось базовий приклад cURL для початку роботи. Замініть заповнювач на свій фактичний API-ключ. Ця команда надсилає короткий запит і очікує прямої відповіді.

Copycurl https://api.iasemsensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate 200 words of dark fantasy lore"}]
  }'

Обробка потокових відповідей

Увімкніть потокове передавання для генерації токенів у реальному часі. Це критично важливо для додатків, які відображають текст по мірі його генерації. API повертає події через Server-Sent Events (SSE). Ви отримуєте фрагменти тексту по мірі їх доступності.

Використовуйте Python SDK для ефективного потокового передавання. Бібліотека керує з'єднанням і повертає токени по мірі їх надходження. Цей підхід зменшує сприйняту затримку для кінцевих користувачів. Він також дозволяє миттєво відображати часткові результати.

Copyfrom openai import OpenAI

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

Виклик функцій та режим JSON

Використовуйте виклик функцій для видобутку структурованих даних або використання інструментів. Визначте свої інструменти в тілі запиту. Модель поверне об'єкт JSON із необхідними аргументами. Ця функція працює разом із звичайною генерацією тексту.

Увімкнути режим JSON для примусового виводу у визначеному форматі. Встановіть response_format до {"type": "json_object"}. Це забезпечує, що відповідь є дійсним JSON. Використовуйте Node SDK для легкої інтеграції з середовищами JavaScript.

Copyimport OpenAI from "openai";

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

Розуміння використання токенів та лімітів

Уважно відстежуйте використання токенів та ліміти запитів. Контекстне вікно підтримує до 100,000 токенів на запит. Це включає як вхідний промпт, так і згенерований вихід. Максимальний вихід становить 16,000 токенів, якщо не вказано інше.

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

Потокова передача

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)