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

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

API вимагає дійсний API-ключ для автентифікації. Ви отримуєте цей ключ одразу після реєстрації через Google або електронну адресу. Передайте його в Authorization header as a Bearer token. The base URL is https://api.topuncensored.com/v1. Ця URL-адреса працює з будь-якою SDK або бібліотекою клієнтів, сумісною з OpenAI.

• Використовуйте заголовок: Authorization: Bearer YOUR_API_KEY
• Встановіть базову URL-адресу вашого клієнта на надану кінцеву точку.

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

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Ендпоінт Chat Completions

Надсилайте текстові промпти до /v1/chat/completions endpoint. endpoint. Ідентифікатор моделі — uncensored. Цей ендпоінт обробляє стандартне форматування чату з повідомленнями. Він повертає текстові відповіді напряму. Немає додаткових шарів або обгортки. Ви контролюєте вікно контексту на 100 000 токенів. Запити до 8 МБ працюють надійно. Використовуйте це для прямої генерації тексту.

Структуруйте запит із системним промптом та повідомленням user. Модель відповідає без фільтрації законного дорослого контенту. Помилки, такі як відсутність ключів, повертають 401. Закінчився кредит? Ви отримаєте помилку 402. Це чіткі сигнали.

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

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

Парсуйте кожен чанк, щоб сформувати фінальну відповідь. Цей метод ефективно обробляє великі виводи. API підтримує стандартні Server-Sent Events. Це рекомендований підхід для інтерактивних додатків.

Copyfrom openai import OpenAI

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

Використовуйте виклик функцій для структурованої взаємодії. Визначте інструменти у своєму запиті. Модель повертає структуровані аргументи. Встановіть response_format до {"type": "json_object"} для суворого виводу JSON. Це забезпечує передбачувані формати даних. Поєднуйте ці функції для надійних інтеграцій. Ви отримуєте точний контроль над структурою виводу.

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

Copyimport OpenAI from "openai";

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

Parameters and Limits

Налаштувати temperature, top_p, а також stop послідовності. Встановіть max_tokens to 16,000. Default is 2,048 if omitted. Control repetition with presence_penalty та frequency_penalty. Використовуйте seed для детермінованих результатів. Ці параметри тонко налаштовують якість генерації. Ви маєте повний контроль над стилем виводу.

Ліміти швидкості становлять 300 запитів на хвилину. Одночасні запити обмежені до 8. Ці ліміти забезпечують стабільну продуктивність. Слідкуйте за використанням через панель керування. Налаштуйте параметри для оптимізації під ваш конкретний випадок використання.

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

Коректно обробляйте помилки. 401 означає недійсний ключ. 402 вказує на недостатній баланс. 429 сигналізує про перевищення лімітів. Контекстне вікно становить 100,000 токенів загалом. Максимальний обсяг виводу — 16,000 токенів. Розумно керуйте токенами. Помилки не споживають кредит. Це економить гроші під час налагодження. Використовуйте останній фрагмент для отримання статистики використання.

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