The OpenRouter API Пояснено

Що таке OpenAI-сумісний API?

Це REST API, що відповідає інтерфейсу chat-completions OpenAI. Ви надсилаєте промпти та отримуєте текстові виводи за допомогою стандартних JSON-пакетів. Ця сумісність означає, що ваш існуючий код клієнта працює без значних змін.

Основна точка доступу — POST /v1/chat/completions. Вона приймає повідомлення у вигляді масиву об’єктів із ролями та вмістом. Ви також можете отримати список доступних моделей через GET /v1/models. Ця стандартизація значно скорочує час інтеграції.

Наш сервіс надає саме цей інтерфейс. Ми надаємо одну модель без цензури під ідентифікатором "uncensored". Вона працює на наших власних серверах. Вона не маршрутизує запити до інших постачальників. Ви отримуєте прямий доступ до потрібної вам моделі.

Контекстні вікна підтримують до 100,000 токенів загалом. Ліміти виходу становлять 16,000 токенів за запит. Потокова передача доступна через Server-Sent Events. Виклик функцій та режим JSON повністю підтримуються.

Розуміння базових URL-адрес та API-ключів

Базовий URL-адреса вказує на сервер, що обробляє ваші запити. Ви замінюєте стандартний URL-адресу OpenAI на нашу специфічну кінцеву точку. Наш базовий URL-адреса: HTTPS://api.openrouterabliterated.com/v1. Ця зміна спрямовує трафік на нашу uncensored інфраструктуру.

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

Обмеження швидкості діють для кожного ключа. Ви можете надсилати 300 запитів за хвилину. До 8 запитів можуть виконуватися одночасно. Розмір тіла запиту обмежено 8 МБ. Ці ліміти добре справляються з великим обсягом використання.

Реєстрація вимагає лише електронну пошту або обліковий запис Google. Номер телефону не потрібен. Ключ з'являється миттєво. Ви можете почати надсилати запити одразу. Конфіденційність зберігається; промпти не використовуються для навчання.

Чому варто обрати модель без фільтрів для вашого випадку використання?

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

Наша модель налаштована на прямі відповіді. Вона обробляє контент 18+ без заперечень. Вона добре працює для політичної філософії або нішевих жанрів. Ви отримуєте стабільну поведінку без додаткових підказок.

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

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

Ціни на токени: Як розраховуються витрати

Ціноутворення базується на використанні токенів. Вхідні токени коштують $0.15 за мільйон токенів. Вихідні токени коштують $0.50 за мільйон токенів. Ви платите лише за те, що використовуєте. Немає прихованих комісій.

Кредит є попередньо оплаченим. Ви поповнюєте баланс лише криптовалютою. Приймаються USDT у мережі TRC20 або USDC на Base. Дозволяється будь-яка ціла сума від $20 до $500. Кредити ніколи не закінчуються. Це унеможливлює прив'язку до підписки.

Бонусні кредити доступні при поповненні. Ви отримуєте +5% від $50. +10% від $100. +15% від $200. Це знижує вашу ефективну вартість. Помилки безкоштовні. Відмови безкоштовні. Ви платите лише за успішні токени.

Пробний акаунт отримує $0,50. Він дійсний протягом 7 днів. Це дозволяє ретельно протестувати API. Ви можете перевірити інтеграцію перед тим, як вносити кошти.

Відповіді в потоковому та непотоковому режимах

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

Ми підтримуємо потокове передавання через SSE. Останній чанк містить використання токенів. Це дозволяє точно відстежувати билінг. Ви можете коректно обробляти часткові відповіді. Помилки обробляються послідовно.

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

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

Function Calling та структурований вивід

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

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

Parameters like temperature and top_p control behavior. Stop sequences limit output. Seeds ensure reproducibility. Penalties reduce repetition. You have fine-grained control.

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

Поширені клієнтські бібліотеки та SDK

Більшість SDK працюють із незначними змінами. Вам потрібно лише оновити base URL. Решта коду залишається незмінною. Це стосується Python, Node.js та інших. Інтеграція проста.

SDK OpenAI є стандартом. Він обробляє автентифікацію та повторні спроби. Ви передаєте свій API-ключ. Базовий URL вказує на наш сервіс. Запити надсилаються звичайним чином.

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

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

Вирішення поширених помилок API

Обмеження швидкості повертають помилки 429. Ви можете надсилати 300 запитів за хвилину. Перевищення цього ліміту викликає затримку. Реалізуйте експоненційне сповільнення. Це запобігає перевантаженню сервера.

Невірні ключі повертають помилку 401. Перевірте свій API-ключ. Переконайтеся, що він активний. Замініть його за необхідності. Кожен акаунт має один ключ. Згенеруйте новий, якщо старий загублено.

Помилки JSON виникають у режимі JSON. Переконайтеся, що ваша схема валідна. Модель повинна повертати валідний JSON. Якщо сталася помилка, спробуйте знову. Налаштуйте temperature для кращої стабільності.

Тайм-аути виникають при довгих генераціях. Збільште значення тайм-ауту. Потікове передавання зменшує ризик тайм-ауту. Часткові відповіді обробляються. Ви можете відновити повний вивід.

Наступні кроки: Отримайте ваш перший API ключ

Перейдіть на сторінку реєстрації. Використовуйте Google або електронну пошту. Номер телефону не потрібен. Процес швидкий. Ви отримуєте миттєвий доступ.

Ваш API-ключ показано. Скопіюйте його в безпечне місце. Використовуйте його у вашому SDK. Встановіть базовий URL на нашу кінцеву точку. Починайте надсилати запити.

Поповнення криптовалютою. Приймаються USDT або USDC. Отримуйте бонусний кредит за більші суми. Кредити не мають терміну дії. Використовуйте їх у своєму темпі.

Протестуйте з пробним кредитом. Він діє 7 днів. Перевірте потокову передачу та виклик функцій. Досліджуйте можливості моделі. Інтегруйте її у свій додаток. API готовий до продукції.