Документация 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. Эта конечная точка возвращает список поддерживаемых идентификаторов моделей. В ответе вы должны увидеть "uncensored".

Эта конечная точка подтверждает, что ваш API-ключ действителен. Она также показывает сведения о модели. Используйте ее для отладки проблем с подключением.

Ответ включает идентификатор модели и тип объекта. Он не перечисляет цены или лимиты. Проверьте документацию по ставкам токенов.

Параметры: Temperature, Top-P и Tools

Управляйте разнообразием генерации с помощью temperature и top_p. Temperature регулирует распределение вероятностей. Top_p фильтрует токены с низкой вероятностью. Вместе они балансируют креативность и фокус.

Используйте вызов функций для структурированного взаимодействия. Определите инструменты в теле запроса. Модель может вызывать эти функции. Передайте tool_choice для принуждения к определенному поведению.

Устанавливайте последовательности stop для досрочного завершения генерации. Используйте seed для воспроизводимых результатов. Параметры presence и frequency penalties уменьшают повторения. Эти параметры соответствуют стандартным соглашениям 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)