за неправильним base_url
Використання стандартної базової URL-адреси OpenAI призводить до збою запитів або маршрутизації до іншої моделі. Наш API вимагає, щоб ви змінили base_url до https://api.whatisopenrouterai.com/v1. Цей єдиний рядок конфігурації гарантує, що ваш SDK підключається до наших серверів, а не до глобальної інфраструктури OpenAI.
Багато розробників копіюють свій існуючий код без оновлення цієї змінної. Якщо ви залишите URL-адресу за замовчуванням, ви або отримаєте помилку 404, або звернетеся до моделі, яка не є uncensored. Завжди перевіряйте з'єднання, оглядаючи /v1/models endpoint. Ви повинні побачити наш специфічний ідентифікатор моделі, зазначений там. Це підтверджує правильність маршрутизації перед надсиланням першого запиту на завершення.
забуваючи встановити id моделі
Навіть із правильною базовою URL-адресою, пропускання ідентифікатора моделі за замовчуванням повертає загальну або стару модель. Ви повинні явно встановити model параметр на "uncensored" в кожному запиті. Це вказує нашому шару маршрутизації обслуговувати конкретну відкриту модель, налаштовану для необмеженого контенту.
Без цієї явної інструкції ви можете отримати іншу модель з іншими правилами вирівнювання. Деякі моделі за замовчуванням відмовляються від законних дорослих тем. Примусово встановлюючи uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
ігнорування лімітів токенів та помилок
Перевищення вікна контексту на 100,000 токенів або ліміту вихідних токенів на 16,000 призводить до миттєвих збоїв запиту. Наш API встановлює максимальну кількість вихідних токенів на рівні 16,000 на запит. Якщо ви не встановите max_tokens, за замовчуванням — лише 2048 токенів. Це часто занадто мало для складних задач міркування.
Помилки та відмови не споживають ваш попередньо оплачений кредит. Однак некоректні запити, які перевищують ліміти частоти або перевищують розмір тіла (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 на ключ. Плануйте налаштування паралелізму відповідним чином.
Якщо ви запускаєте кілька процесів, переконайтеся, що вони використовують один і той самий ключ або згенеруйте окремі ключі. Кожен обліковий запис підтримує один активний ключ. Новий ключ замінює старий. Слідкуйте за заголовками ліміту швидкості у відповіді. Реалізуйте експоненційне сповільнення у вашій логіці повторних спроб. Це запобігає каскадним збоям під час періодів високого навантаження.
затримки поповнення криптовалютою
Транзакції криптовалютою можуть займати час на підтвердження в блокчейні. Ваш кредит може не з’явитися миттєво після відправлення коштів. Використовуйте правильну мережу: TRC20 для USDT або Base для USDC. Відправка в неправильну мережу призводить до втрати коштів.
Поповнення варіюються від $20 до $500. Переконайтеся, що ви надсилаєте точну суму або враховуєте комісії мережі. Перевірте хеш транзакції в оглядачі блокчейну. Якщо кредит надходить із затримкою, зверніться до підтримки з ID транзакції. Не припускайте, що платіж не пройшов одразу. Терпіння під час перевантаження мережі є ключем до безперебійної роботи.
