Посібник з інтеграції

Швидкий старт: Ваш перший запит

API є сумісним з openai і відтворює структуру 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)

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

• Встановити 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 сигналізують проблеми автентифікації.

• Помилки безкоштовні. Ви платите лише за успішне використання токенів.
• Відмови через політику контенту також безкоштовні.

Перевірте тіло відповіді на наявність детальних повідомлень про помилки. Використовуйте їх для налаштування логіки повторних спроб або частоти поповнення кредитів.