Понимание базового URL
Базовый URL определяет, куда ваш клиент отправляет запросы. Несоответствие здесь вызывает немедленные сбои подключения или неожиданные ответы модели. Многие разработчики полагают, что стандартный URL OpenAI работает универсально, но провайдеры нецензурированных моделей часто используют различные эндпоинты для маршрутизации трафика к конкретным пулам моделей.
Убедитесь, что ваша конфигурация указывает на https://api.openrouterabliteratedmodels.com/v1 для нашего сервиса. Если вы используете сторонний агрегатор, убедитесь, что базовый URL точно соответствует их документации. Неправильные URL часто приводят к ошибкам 404 или ответам от моделей по умолчанию вместо предполагаемого варианта без цензуры.
- Проверьте переменные среды на наличие
BASE_URLилиAPI_HOST. - Убедитесь, что путь включает
/v1для стандартной совместимости. - Протестируйте подключение с помощью простого запроса списка моделей перед интенсивным использованием.
Обработка ограничений частоты запросов
Лимиты скорости ограничивают количество запросов, которые вы можете отправить за определённый промежуток времени. Наш API устанавливает лимит в 300 запросов в минуту на ключ. Превышение этого порога приводит к ошибке HTTP 429, временно блокируя дальнейшие запросы до сброса окна.
Кроме того, существует ограничение на одновременные запросы: 8 запросов одновременно на ключ. Если вы отправите более 8 одновременных запросов, лишние будут поставлены в очередь или отклонены в зависимости от вашей клиентской библиотеки. Отслеживайте параллелизм вашего приложения, чтобы избежать достижения этих жестких ограничений. Используйте стратегии экспоненциальной задержки в коде для graceful обработки ошибок 429, не перегружая сервер.
Помните, что каждый ключ уникален для вашего аккаунта. Использование ключей в нескольких сервисах может ускорить достижение этих лимитов. Сгенерируйте новый ключ, если вам нужны отдельные пулы лимитов частоты запросов для разных частей вашего приложения.
Ответы при потоковой и непотоковой передаче
Потоковая передача возвращает данные инкрементально по мере генерации токенов, в то время как не потоковая передача ждет полного ответа. Потоковая передача необходима для пользовательского опыта в реальном времени, но требует тщательной обработки Server-Sent Events (SSE).
При потоковой передаче финальный фрагмент содержит статистику использования токенов. Если вы прекратите обработку досрочно, вы можете упустить эти данные. Убедитесь, что ваш клиент разбирает последнее сообщение SSE для точного получения количества входных и выходных токенов. Непотоковые ответы проще, но могут вызывать высокую задержку для длинных выводов.
Выбирайте streaming для чат-интерфейсов, где пользователи видят, как текст появляется посимвольно. Используйте non-streaming для пакетной обработки или когда вам нужен полный ответ перед продолжением. Наш API поддерживает оба режима через stream параметр в теле запроса.
Ошибки режима JSON
Режим JSON гарантирует, что модель выводит валидный JSON, что критично для программной интеграции. Ошибки здесь часто возникают из-за неверных заголовков или несоответствия схем. API требует response_format: {"type": "json_object"} для обеспечения строгого вывода JSON.
Если вы получили некорректный JSON, проверьте определение вашей схемы. Модель может включать блоки кода Markdown или пояснительный текст вне структуры JSON. Используйте надежный парсер, который может удалять маркдаун-ограничители или проверять вывод на соответствие вашей ожидаемой схеме. Избегайте слишком сложных схем, которые могут запутать модель.
Протестируйте сначала с простыми структурами. Постепенно добавляйте сложность, чтобы определить, где модель испытывает трудности. Убедитесь, что температура установлена appropriately, так как более высокие значения могут увеличить случайность и снизить валидность JSON.
Ошибки подсчета количества токенов
Количество токенов определяет биллинг и использование контекстного окна. Ошибки в расчётах могут привести к неожиданным расходам или усечённым ответам. Наш API взимает $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов.
Используйте надёжную библиотеку токенизации, соответствующую схеме токенизации модели. Разные модели по-разному токенизируют пробелы или пунктуацию, что приводит к расхождениям между вашим локальным подсчётом и подсчётом API. Всегда опирайтесь на использование токенов, возвращаемое в ответе, для точного биллинга.
Следите за окном контекста, которое составляет 100,000 токенов в общей сложности. Превышение этого лимита приведет к ошибкам. Обрезайте старые сообщения или сводки, чтобы оставаться в пределах лимита. Отслеживайте использование токенов со временем, чтобы оптимизировать структуру промптов и снизить затраты.
Задержки при оплате криптовалютой
Пополнение криптой через USDT (TRC20) или USDC (Base) обрабатывается мгновенно. Однако из-за нагрузки на сеть подтверждения могут занимать немного больше времени. Убедитесь, что отправляете правильную сумму и используете верную сеть, чтобы избежать потери средств.
Пополнения варьируются от $20 до $500 целыми суммами. Бонусные кредиты применяются автоматически: +5% от $50, +10% от $100 и +15% от $200. Подтвердите хеш транзакции, чтобы подтвердить платеж. Если кредиты не появятся в течение нескольких минут, проверьте статус транзакции в обозревателе блокчейна.
Кредит не сгорает, поэтому нет спешки с его использованием. Ошибки, такие как двойные списания, решаются через страницу поддержки. Сохраняйте записи о транзакциях для удобства, если возникнут проблемы.
Конфигурация идентификатора модели
Идентификатор модели указывает, какую версию uncensored модели вы используете. Для нашего сервиса идентификатор модели — uncensored. Использование неверного идентификатора может привести к ошибкам или неожиданному поведению.
Убедитесь, что ваши запросы указывают model: "uncensored" в теле запроса. Этот ID указывает на нашу конкретную open-weight модель, настроенную для неограниченных ответов. Это не общий идентификатор, а конкретный указатель на наш размещенный экземпляр.
Проверьте документацию библиотеки клиента, чтобы узнать, как установить идентификатор модели. Некоторые библиотеки используют model поле, в то время как другие могут использовать другой параметр. Согласованность использования идентификатора модели в вашем приложении предотвращает путаницу и гарантирует, что вы всегда вызываете нужную uncensored модель.
Превышения контекстного окна
Контекстное окно ограничивает общее количество токенов, которые вы можете отправить в одном запросе. Наш API поддерживает окно на 100,000 токенов, включая как промпт, так и завершение. Превышение этого лимита приводит к ошибке.
Для управления контекстом реализуйте стратегию скользящего окна. Удаляйте старые сообщения или суммируйте их, чтобы освободить место. Отслеживайте количество токенов в вашем вводе, чтобы убедиться, что оно остается в пределах лимита в 100,000 токенов. Если вы превысите лимит, API отклонит запрос.
Используйте max_tokens параметр для управления длиной вывода. Максимальный объем вывода на запрос составляет 16 000 токенов. Установка этого параметра помогает предотвратить чрезмерное использование токенов и удерживает ответы в пределах, удобных для вашего приложения.
Политика поддержки и возврата средств
Кредит не возвращается после использования, но он не истекает. Если возникнут проблемы с платежами или сервисом, свяжитесь с Поддержкой через указанную страницу. Ошибки, такие как двойное списание, устраняются командой Поддержки.
При технических проблемах сначала проверьте документацию. Наш API прост в использовании, но могут возникать пограничные случаи. Предоставьте свой API-ключ и детали запроса при обращении за помощью. Время ответа варьируется, но мы стремимся быстро решать проблемы.
Помните, что кредит предоплачивается. Вы платите за то, что потребляете, а ошибки и отказы бесплатны. Эта модель обеспечивает прозрачность биллинга. Используйте страницу поддержки для любых несоответствий или вопросов по вашему аккаунту.
