Довідник API

Аутентифікація та базовий URL

Використовуйте свій API-ключ із https://api.routerllm.cc/v1 базова URL-адреса. Зареєструйтеся через Google або електронну пошту та пароль, щоб миттєво отримати свій ключ. Номер телефону не потрібен. Ключ аутентифікує всі запити до кінцевої точки chat-completions.

Copycurl https://api.routerllm.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 python libraries for web scraping."}]
  }'

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

Ендпоінт Chat Completions

Надсилайте запити до POST /v1/chat/completions endpoint. endpoint. Ідентифікатор моделі — uncensored. Це модель з відкритими вагами, налаштована на законне доросле використання, а не модель постачальника, як GPT чи Claude.

Copyfrom openai import OpenAI

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

Розмір контекстного вікна становить 100 000 токенів для запиту та відповіді разом. За замовчуванням ви отримуєте 16 000 токенів відповіді, або 2 048, якщо ви пропустили max_tokens.

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

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

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 та інструменти

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

Copyimport OpenAI from "openai";

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

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

Режим JSON та параметри

Встановити response_format до {"type": "json_object"} для суворого виводу JSON. Керуйте генерацією за допомогою temperature, top_p, stop, а також seed. Налаштуйте штрафи за наявність та частоту, щоб уточнити стиль виводу.

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

Обробка помилок та обмеження

Очікуйте 401 для недійсних ключів, 402 для недостатнього кредиту та 429 для лімітів швидкості. Ліміт становить 300 запитів на хвилину та 8 одночасних запитів на ключ. Максимальний розмір тіла запиту становить 8 МБ.

Перевірте код статусу, щоб визначити причину. Поповніть баланс за допомогою USDT або USDC, щоб продовжити. Кредит не має строку дії, тому ви можете призупинити використання без втрати коштів.

Інформація про модель та використання токенів

Запит GET /v1/models перевірити доступні моделі. Єдина модель — uncensored. Вона приймає текст і повертає текст. Векторні вбудовування, зображення чи аудіо не підтримуються.

Відстежуйте використання токенів у заголовках відповіді або в кінці потоку. Ціноутворення прозоре: $0.15 за 1M вхідних токенів та $0.50 за 1M вихідних токенів. Передоплачений кредит покриває все використання.