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

Швидкий старт: Підключіть перший запит

Почніть із генерації вашого ключа на панелі керування. Базова URL-адреса для всіх запитів — HTTPS://api.filterno.cc/v1. Передавайте свій ключ у заголовку Authorization як токен bearer. Ця настройка працює з будь-яким стандартним клієнтом, сумісним з OpenAI.

Протестуйте з’єднання миттєво за допомогою простого запиту на завершення. Точка доступу приймає стандартні формати чату та повертає необроблений текст без фільтрів контенту.

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

Точка доступу: POST /v1/chat/completions

Надішліть свої промпти до POST /v1/chat/completions. Це єдина кінцева точка чату, яку ми підтримуємо. Ви надаєте системну інструкцію та повідомлення користувача у форматі масиву.

Ідентифікатор моделі — "uncensored". Він обробляє текстовий вхід і повертає текстовий вивід. Не очікуйте тут генерації зображень чи аудіо.

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

Точка доступу: GET /v1/models

Перевірте доступні моделі за допомогою GET-запиту до /v1/models. Цей ендпоінт повертає список підтримуваних ID моделей. У відповіді ви повинні побачити "uncensored".

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

Відповідь включає ідентифікатор моделі та тип об'єкта. Вона не перелічує ціни чи обмеження. Перевірте документацію щодо ставок за токени.

Параметри: Temperature, Top-P та Інструменти

Керуйте різноманітністю генерації за допомогою temperature та top_p. Temperature регулює розподіл ймовірностей. Top_p фільтрує токени з низькою ймовірністю. Разом вони збалансовують креативність та фокус.

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

Встановіть послідовності stop для дострокового завершення генерації. Використовуйте seed для відтворюваних результатів. Штрафи за наявність та частоту зменшують повторення. Ці параметри відповідають стандартним угодам OpenAI.

Потокові відповіді (SSE) та використання токенів

Увімкніть потокову передачу, встановивши stream у true. API повертає події, надані сервером (SSE). Кожен чанк містить часткові дані токенів.

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

Обережно парсуйте структуру даних SSE. Обробляйте мережеві переривання коректно. API забезпечує цілісність даних через межі чанків.

Ліміти, помилки та арифметика токенів

Ви отримуєте 300 запитів на хвилину на ключ. Паралельність обмежена 8 одночасними запитами. Максимальний розмір тіла запиту становить 8 МБ.

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

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

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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

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)