Інтеграція routerapi за хвилини

Налаштування автентифікації та базового URL

Змінити base_url та api_key для миттєвого перемикання постачальників. Вкажіть ваш SDK на HTTPS://api.routerapi.cc/v1 та використовуйте ключ, згенерований у вашій панелі керування. Не потрібні складні правила маршрутизації або конфігурація кількох моделей. Ваші існуючі заголовки та налаштування клієнта залишаються ідентичними стандарту OpenAI.

Ключ відображається миттєво після реєстрації через Google або електронну пошту. Зберігайте його в безпеці та передавайте як Bearer токен у заголовку HTTP Authorization. Ця одна зміна маршрутизує всі запити до нашої uncensored моделі без зміни коду вашої програми.

Надсилання запиту на завершення чату

Стандартний POST запит на /v1/chat/completions для генерації тексту. Ендпоінт приймає ту саму JSON-структуру, що й OpenAI, що гарантує сумісність ваших промптів без змін. Використовуйте ID моделі uncensored для доступу до нашої великої мовної моделі, налаштованої для необмежених відповідей.

Кожен запит споживає токени з вашого передоплаченого балансу. Помилки та відмови не нараховують плату на ваш кредит, тому ви можете тестувати вільно. Наведений нижче приклад демонструє базовий виклик генерації тексту за допомогою офіційного SDK.

Copycurl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

Відповідь повертає згенерований текст у choices[0].message.content поле. Ви можете налаштувати такі параметри, як temperature або top_p для контролю креативності. Ендпоінти для вбудовування або генерації зображень недоступні; цей сервіс зосереджений суто на завершенні тексту.

Обробка потокових відповідей (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)

Останній фрагмент включає повну статистику використання токенів для запиту. Спарсіть content field з кожного дельти, щоб відновити повне повідомлення. Цей підхід підтримує інтерфейс користувача в стані відгуку, поки модель обробляє довгі контексти. Кількість токенів у фінальному чанку відображає використання як вхідних, так і вихідних даних.

Використання Tools та Function Calling

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

Copyfrom openai import OpenAI

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

Визначте ваші функції з схемами JSON та передайте їх у запиті. API обробляє маршрутизацію між генерацією тексту та викликом інструментів. Використовуйте response_format параметром {"type": "json_object"} для суворого виводу JSON, коли інструменти не потрібні. Це забезпечує стабільні структуровані дані для ваших бекенд-сервісів.

Налаштування режиму JSON для структурованого виводу

Змушуйте модель виводити валідний JSON, встановивши response_format до {"type": "json_object"}. Це необхідно для обробки даних у автоматизованих робочих процесах або AI-агентів. Модель намагатиметься закрити всі дужки та дотримуватися зазначеної схеми. Можуть виникнути помилки, якщо вихідний текст стане занадто довгим для контекстного вікна.

Copyimport OpenAI from "openai";

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

Поєднуйте режим JSON з temperature встановлено на 0 для максимальної детермінованості. Використовуйте це для видобутку сутностей, форматування даних або генерації конфігураційних файлів. Модель без цензури добре справляється зі складними вкладеними структурами. Завжди перевіряйте вихідні дані у своєму коді перед обробкою.

Розуміння обмежень на токени та витрат

Вікно контексту підтримує 100,000 токенів як для запиту, так і для відповіді разом. Кожен запит може повертати до 16,000 токенів, або 2,048, якщо max_tokens не встановлено. Ціна становить $0.15 за мільйон вхідних токенів та $0.50 за мільйон вихідних токенів. Кредит не має строку дії, а помилки є безкоштовними.

Стежте за використанням через панель моніторингу або заголовки відповіді. Запити обмежені розміром тіла 8 МБ. Ви можете поповнити баланс за допомогою USDT (TRC20) або USDC (Base) від $20. Бонусний кредит збільшується з більшими депозитами: +5% при $50, +10% при $100 та +15% при $200. Платежі за підписку не стягуються.