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. Номер телефона не нужен. Ключ появляется мгновенно. Вы можете начать отправлять запросы сразу. Конфиденциальность сохраняется; промпты не используются для обучения.

Почему стоит выбрать uncensored модель для вашего сценария?

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

Наша модель настроена на прямой ответ. Она обрабатывает контент NSFW без сопротивления. Она хорошо работает для политической философии или нишевых жанров. Вы получаете стабильное поведение без дополнительных промптов.

Использование инструментов поддерживается. Вы можете определить инструменты для своего приложения. Модель уважает выбор инструментов. Это делает ее подходящей для сложных рабочих процессов. Ошибки и отказы бесплатны. Вы платите только за реальное использование.

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

Тарификация токенов: как рассчитываются расходы

Тарификация основана на использовании токенов. Входные токены стоят $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. Это полезно для извлечения данных. Вы получаете согласованные форматы. Парсинг упрощается. Ошибки редки.

Параметры, такие как температура и top_p, управляют поведением. Последовательности остановки ограничивают вывод. Seed обеспечивает воспроизводимость. Штрафы уменьшают повторение. У вас есть тонкий контроль.

Выбор инструмента может быть автоматическим или принудительным. Вы указываете предпочтение модели. Это направляет процесс генерации. Это повышает надежность. Ваше приложение остается стабильным.

Распространённые клиентские библиотеки и SDK

Большинство SDK работают с незначительными изменениями. Вам нужно лишь обновить base URL. Остальная часть кода остаётся прежней. Это относится к Python, Node.js и другим. Интеграция проста.

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

Потоковая передача поддерживается во всех SDK. Вы перебираете фрагменты. Использование токенов доступно в последнем фрагменте. Это соответствует нашей модели биллинга. Ошибки ловятся последовательно.

Вызов функций встроен в современные SDK. Вы передаете определения инструментов. SDK разбирает ответы. Ваш код выполняет инструменты. Цикл продолжается до завершения. Это эффективно и надежно.

Устранение распространенных ошибок API

Лимиты скорости возвращают ошибки 429. Вы можете отправлять 300 запросов в минуту. Превышение этого порога требует ожидания. Реализуйте экспоненциальное замедление. Это предотвращает перегрузку сервера.

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

В режиме JSON возникают ошибки. Убедитесь, что ваша схема валидна. Модель должна возвращать корректный JSON. Если это не так, повторите запрос. Настройте температуру для повышения стабильности.

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

Следующие шаги: Получение первого API-ключа

Перейдите на страницу регистрации. Используйте Google или электронную почту. Номер телефона не требуется. Процесс быстрый. Вы получаете мгновенный доступ.

Ваш API-ключ показан. Скопируйте его в безопасное место. Используйте его в вашем SDK. Установите базовый URL на нашу конечную точку. Начните отправлять запросы.

Пополнение криптовалютой. Принимаются USDT или USDC. Получайте бонусные кредиты за большие суммы. Кредиты не имеют срока действия. Используйте их в своем темпе.

Протестируйте с пробным кредитом. Он действует 7 дней. Проверьте потоковую передачу и вызов функций. Изучите возможности модели. Интегрируйте ее в свое приложение. API готов к производству.