Руководство по интеграции

Быстрый старт: Ваш первый запрос

API представляет собой совместимую с openai API, которая зеркально отображает структуру Chat Completions. Вы отправляете текст, получаете текст. Никаких дополнительных конечных точек для эмбеддингов или аудио, которые загромождают рабочий процесс. Начните с указания клиенту нашего базового URL.

• Базовый URL: HTTPS://api.filtrosemia.com/v1
• Идентификатор модели: "uncensored"

Замените существующий базовый URL в конфигурации SDK. Эндпоинт обрабатывает всё: от ролевых игр до перевода, без обычных ограничений.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Аутентификация и заголовки

Передавайте ваш API-ключ в стандартном заголовке Authorization. Мы используем один активный ключ на аккаунт для простоты. Если вам нужен новый, сгенерируйте его на панели управления.

• Заголовок: Authorization: Bearer YOUR_API_KEY
• Не нужно управлять OAuth-потоками или токенами обновления.

Храните ваш ключ в безопасности. Он предоставляет прямой доступ к вашим предоплаченным кредитам. Ошибки, такие как 401 Unauthorized Означает, что ключ отсутствует или недействителен.

Copyfrom openai import OpenAI

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

Эндпоинт Chat Completions

Отправляйте сообщения в POST /v1/chat/completions. Модель поддерживает стандартные параметры, такие как temperature, top_p, и stop последовательности. Это uncensored модель, настроенная на контент для взрослых и творческие задачи.

• Поддерживает json_object формат ответа.
• Принимает определения инструментов для вызова функций.

Запросы обрабатываются последовательно в рамках ваших лимитов частоты запросов. Убедитесь, что размер вашего пэйлоада не превышает 8 МБ.

Copyimport OpenAI from "openai";

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

Потоковые ответы (SSE)

Используйте Server-Sent Events для доставки токенов в реальном времени. Это снижает воспринимаемую задержку для длинных выводов. Последний чанк содержит полную статистику использования токенов.

• Установить stream: true в запросе.
• Разберите поток SSE в вашем клиенте.

Стриминг работает идентично поведению стандартного SDK OpenAI. Вы обрабатываете чанки по мере их поступления.

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)

Контекстное окно и лимиты

Модель поддерживает контекстное окно объёмом 100,000 токенов. Это позволяет обрабатывать большие нагрузки с длинными историями. Максимальный объём вывода составляет 16,000 токенов за запрос.

• Максимальный вывод по умолчанию: 2 048 токенов.
• Лимит запросов: 300 запросов в минуту.

Превышение лимитов вызывает 429 Too Many Requests ошибка. Скорректируйте параллелизм, чтобы оставаться в пределах лимитов. На один ключ разрешено 8 одновременных запросов.

Обработка ошибок и токены

Обрабатывайте стандартные ошибки HTTP. 402 Payment Required Означает, что ваш предоплаченный кредит исчерпан. 429 указывает на ограничение частоты запросов. 401 сигнализирует об ошибках аутентификации.

• Ошибки бесплатны. Вы платите только за успешное использование токенов.
• Отказы из-за политики контента также бесплатны.

Проверьте тело ответа на наличие подробных сообщений об ошибках. Используйте их для корректировки логики повторных попыток или частоты пополнения кредита.