с использованием неверного base_url
Использование стандартного базового URL OpenAI приводит к сбою запросов или маршрутизации на совершенно другую модель. Наш API требует, чтобы вы изменили base_url для https://api.whatisopenrouterai.com/v1. Эта единственная строка конфигурации гарантирует, что ваш SDK подключается к нашим серверам, а не к глобальной инфраструктуре OpenAI.
Многие разработчики копируют-вставляют свой существующий код, не обновляя эту переменную. Если вы оставите URL по умолчанию, вы либо получите ошибку 404, либо попадёте на модель, которая не является uncensored. Всегда проверяйте соединение, проверяя /v1/models endpoint. Вы должны увидеть там указанный наш конкретный идентификатор модели. Это подтверждает правильность маршрутизации перед отправкой первого запроса на завершение.
забывая установить id модели
Даже с правильным базовым URL, если опустить ID модели, по умолчанию используется generic или более старая модель. Вы должны явно установить model параметр на "uncensored" в каждом запросе. Это указывает нашему маршрутизатору обслуживать конкретную open-weight модель, настроенную для неограниченного контента.
Без этого явного указания вы можете получить другую модель с другими правилами выравнивания. Некоторые модели по умолчанию отказываются от законных взрослых тем. Принуждая uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
ignoring token limits and errors
Превышение окна контекста в 100 000 токенов или лимита вывода в 16 000 токенов приводит к немедленному отказу в запросе. Наш API устанавливает максимальный вывод в 16 000 токенов на запрос. Если вы не установите max_tokens, по умолчанию только 2 048 токенов. Это часто слишком мало для задач сложного рассуждения.
Ошибки и отказы не расходуют ваш предоплаченный кредит. Однако некорректные запросы, превышающие лимиты частоты или превышающие размер тела (8 МБ), все равно засчитываются в вашу квоту. Отслеживайте заголовки ответов для использования токенов. Настройте промпт-инжиниринг, чтобы уложиться в контекстное окно. Это предотвращает дорогостоящие повторные попытки и обеспечивает плавный поток данных.
непонимание предоплаченного биллинга
Баланс вашего аккаунта привязан к предоплаченному кредиту, а не к ежемесячной подписке. Мы берем $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов. Ошибки бесплатны, но успешные завершения потребляют кредит. Вы должны пополнить баланс через криптовалюту, чтобы поддерживать доступность сервиса.
Мы принимаем USDT (TRC20) или USDC (Base) для пополнений. Минимальная сумма — $20. Бонусы применяются на более высоких уровнях: +5% от $50, +10% от $100 и +15% от $200. Кредиты не истекают. Убедитесь, что баланс положительный перед запуском крупных пакетов. Проверьте панель управления, чтобы подтвердить текущий баланс и недавние транзакции.
путать потоковую передачу со стандартными ответами
Потоковая передача через SSE изменяет способ парсинга потока ответов. Обычные ответы возвращают один объект JSON. Потоковая передача возвращает несколько чанков. Вы должны обработать финальный чанк, чтобы получить точную статистику использования токенов.
Наша реализация потоковой передачи включает использование токенов в последнем чанке. Если вы прервёте чтение потока раньше времени, эти данные могут быть потеряны. Убедитесь, что ваша клиентская библиотека корректно поддерживает SSE. Это критически важно для приложений реального времени, где токены отображаются по мере их генерации. Неправильная настройка потоковой передачи может привести к неполному тексту или нарушению состояния интерфейса.
ошибки конфигурации tool_choice
Неправильный tool_choice настройки могут помешать работе вызова функций так, как ожидалось. Вы можете принудительно использовать определенный инструмент или позволить модели принять решение. Неправильная конфигурация часто приводит к тому, что модель игнорирует доступные функции.
Использовать tool_choice для управления тем, вызывает ли модель инструменты автоматически. Установите значение "auto" для гибкости или укажите идентификатор инструмента для строгого поведения. Убедитесь, что ваши определения функций соответствуют ожидаемой схеме. Это предотвратит ошибки времени выполнения, когда модель попытается вызвать несуществующую функцию. Тщательно протестируйте определения инструментов перед развертыванием в продакшене.
отсутствует режим json_object
Без response_format: {"type": "json_object"}, модель может выводить markdown или обычный текст. Это ломает парсеры, ожидающие строгий JSON. Включите режим JSON для обеспечения согласованного и парсимого вывода.
Эта функция необходима для интеграции с последующими системами, требующими структурированных данных. Она значительно снижает накладные расходы на постобработку. Всегда проверяйте схему вывода в коде клиента. Это обеспечивает устойчивость к случайным галлюцинациям модели. Используйте этот режим при извлечении сущностей или генерации конфигурационных файлов.
неожиданные лимиты частоты
Наш API позволяет выполнять 300 запросов в минуту на один ключ. Превышение этого лимита приводит к ответу 429 Too Many Errors. Одновременные запросы ограничены 8 на ключ. Настройте параметры параллелизма соответственно.
Если вы запускаете несколько процессов, убедитесь, что они используют один и тот же ключ или сгенерируйте отдельные ключи. Каждый аккаунт поддерживает один активный ключ. Новый ключ заменяет старый. Отслеживайте заголовки лимитов скорости в ответе. Реализуйте экспоненциальное замедление в логике повторных попыток. Это предотвращает каскадные сбои в периоды высокой нагрузки.
crypto top-up delays
Подтверждение крипто-транзакций может занимать время в блокчейне. Ваш кредит может появиться не сразу после отправки средств. Используйте правильную сеть: TRC20 для USDT или Base для USDC. Отправка в неправильную сеть приводит к потере средств.
Пополнения от $20 до $500. Убедитесь, что вы отправляете точную сумму или учитываете сетевые комиссии. Проверьте хеш транзакции в обозревателе блоков. Если кредит задерживается, свяжитесь с поддержкой, указав ID транзакции. Не предполагайте, что платеж не прошел сразу. Терпение во время сетевых перегрузок — ключ к бесперебойной работе.
