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

Базова URL-адреса та аутентифікація

Базовий URL-адреса — https://api.routeria.cc/v1. Передайте свій API-ключ у Authorization header. Помилки та відмови безкоштовні, тому ви платите лише за згенеровані токени.

• GET /v1/models перелічує доступні моделі.
• POST /v1/chat/completions handles text generation.

Аутентифікація суворий. Помилка 401 означає, що ваш ключ недійсний або відсутній. Помилка 402 вказує на недостатній попередньо оплачений кредит. Ви можете поповнити рахунок за допомогою USDT (TRC20) або USDC (Base).

Перший запит через cURL

Відправте POST-запит до кінцевої точки chat completions. ID моделі uncensored. Це модель з відкритими вагами, налаштована на відповіді без відмови вмісту для законного дорослого використання.

Ви повинні встановити Content-Type header для application/json. Тіло запиту містить ідентифікатор моделі та ваш масив повідомлень.

Помилки не списуються з вашого кредиту. Ви можете перевірити свій ключ, спочатку викликавши кінцеву точку моделей.

Copycurl https://api.routeria.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how the router handles packet loss"}]
  }'

Інтеграція SDK Python

Використовуйте офіційний OpenAI Python SDK. Встановіть базовий URL на https://api.routeria.cc/v1 і надайте свій API-ключ. Ідентифікатор моделі залишається uncensored.

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

Потокова передача підтримується через stream параметр. Ви отримуєте фрагменти тексту по мірі їх генерації.

Copyfrom openai import OpenAI

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

Ініціалізуйте клієнт, використовуючи правильний базовий URL та API-ключ. Передайте ідентифікатор моделі uncensored у ваших запитах на завершення.

SDK Node відтворює реалізацію Python. Ви можете потоково передавати відповіді або чекати повного завершення. Використання токенів повідомляється в останньому фрагменті.

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

Copyimport OpenAI from "openai";

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

Потокова передача та використання токенів

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. Ви отримуєте події, надіслані сервером (SSE) для кожного токена.

Останній чанк містить повну статистику використання токенів. Вхідні токени нараховуються за $0.15 за 1M токенів. Вихідні токени коштують $0.50 за 1M токенів.

Потокова передача зменшує сприйняту затримку. Ви можете відображати текст по мірі його надходження. Контекстне вікно підтримує 100,000 токенів загалом.

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)

Function Calling та режим JSON

Увімкнути виклик функцій із tools параметр. Модель підтримує tool_choice для суворого контролю. Використовуйте response_format: {"type": "json_object"} для структурованого виводу.

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

Ви можете поєднувати інструменти з потоковою передачею. Модель буде викликати функції за потреби. Усі параметри, такі як temperature та top_p підтримуються.

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

Налаштувати temperature для творчості. Нижчі значення роблять результати більш детермінованими. top_p контролює вибірку ядра (nucleus sampling). Встановіть stop послідовності для зупинки генерації.

Інші підтримувані параметри включають seed, presence_penalty, а також frequency_penalty. Це дозволяє тонко налаштовувати стиль виводу.

Максимальна кількість токенів за замовчуванням становить 2,048. Ви можете збільшити її до 16,000 токенів на запит. Загальне контекстне вікно становить 100,000 токенів.

Ліміти та квоти

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

Помилка 429 вказує на перевищення ліміту швидкості. Зачекайте перед повторною спробою. Кожен акаунт має один активний ключ; новий ключ замінює старий.

ID моделі завжди uncensored. Це не GPT, Claude чи інша модель постачальника. Це модель з відкритими вагами, що працює на наших серверах.