OpenRouter API key: посібник

Як отримати ключ API OpenRouter і користуватися безкоштовними моделями

Як створити ключ API OpenRouter, які ліміти в безкоштовних моделей, як виправити помилки 401, 402 і 429 і користуватися OpenRouter на iPhone, Android чи у вебі.

Оновлено
  • Щоб отримати API key (ключ API) OpenRouter, увійдіть на openrouter.ai, відкрийте openrouter.ai/keys і створіть ключ; він починається з «sk-or-v1-». Створити ключ можна безкоштовно, моделями з ID, що закінчується на «:free», можна користуватися в межах денних лімітів, а решта моделей оплачується з передплачених кредитів.
  • OpenRouter — це один акаунт і один ключ до моделей багатьох компаній, що розробляють ШІ. Власного чат-застосунку для iPhone чи Android OpenRouter не випускає, тож на телефоні потрібен чат-застосунок, який приймає ключ OpenRouter, наприклад Oriveo.
  • Станом на 18 листопада 2026 року безкоштовні моделі дозволяють 20 запитів на хвилину і 50 на день, а якщо ви купили щонайменше 10 кредитів — 1000 на день. Помилка 402 означає, що кредити закінчилися.
Oriveo на iPhone: екран постачальників зі списком підключених вами постачальників і витратами за цей місяць.

Що таке OpenRouter і що таке ключ API?

OpenRouter — це сервіс, який дає доступ до моделей багатьох компаній, що розробляють ШІ, через один акаунт. Замість того щоб реєструватися в кожній компанії окремо, ви один раз поповнюєте кредити в OpenRouter і вибираєте моделі з його списку.

Ключ API — це секретний код, з яким застосунок надсилає запити від імені вашого акаунта. OpenRouter перевіряє ключ, передає ваше повідомлення вибраній моделі й списує вартість із ваших кредитів OpenRouter.

OpenRouter створено для застосунків і розробників. Власного чат-застосунку для iPhone чи Android він не випускає, тому люди й шукають «застосунок OpenRouter». Насправді їм потрібен чат-застосунок, який приймає ключ OpenRouter.

Як отримати ключ API OpenRouter?

На сайті OpenRouter це займе кілька хвилин.

  • Перейдіть на openrouter.ai і створіть акаунт або увійдіть.
  • Відкрийте сторінку ключів openrouter.ai/keys і створіть новий ключ. Назвіть його за застосунком чи пристроєм, де ним користуватиметеся.
  • Скопіюйте ключ. Ключі OpenRouter починаються з «sk-or-v1-» і мають довжину 73 символи, тож перевірте, що скопіювали його повністю.
  • Якщо вам потрібні платні моделі, поповніть кредити на сторінці Credits.
  • Зберігайте ключ у надійному місці, наприклад у менеджері паролів. Якщо він потрапив у чужі руки, видаліть його на сторінці ключів і створіть новий.

Чи безкоштовний API OpenRouter?

Частково. Створити акаунт і ключ нічого не коштує, а ще OpenRouter пропонує безкоштовні моделі, ID яких закінчується на «:free». Усе інше оплачується з передплачених кредитів. OpenRouter також пише, що нові користувачі отримують невелику суму безкоштовних кредитів, але не уточнює, скільки саме.

Безкоштовні моделі мають ліміти. Ось ліміти, опубліковані OpenRouter, станом на 18 листопада 2026 року:

  • Якщо ваш баланс опуститься нижче нуля, то, за словами OpenRouter, помилки можуть повертати навіть безкоштовні моделі.
  • Які моделі зараз мають версію «:free», видно на сайті OpenRouter; перевірте це там, перш ніж на неї покладатися.
Чи безкоштовний API OpenRouter?
Ваш акаунтЗапитів до безкоштовних моделей на хвилинуЗапитів до безкоштовних моделей на день
Загалом куплено менше ніж 10 кредитів2050
Загалом куплено щонайменше 10 кредитів201000

Як працюють кредити OpenRouter?

OpenRouter працює за передоплатою. Ви купуєте кредити на сторінці Credits карткою або іншим зазначеним там способом оплати, і вартість кожного запиту списується з них. Станом на 18 листопада 2026 року умови OpenRouter встановлюють мінімум $5 за одну покупку, додають комісію за платіж і передбачають, що термін дії невикористаних кредитів може сплинути через 365 днів після покупки. Актуальні подробиці — на openrouter.ai/terms.

Кожна модель має власну ціну за токен, указану на її сторінці в OpenRouter. Ми не копіюємо ціни сюди, бо вони змінюються. Oriveo показує орієнтовну вартість кожної відповіді; остаточний облік — на сторінках активності та оплати OpenRouter.

Як користуватися OpenRouter на iPhone, Android чи у вебі?

Офіційного мобільного застосунку OpenRouter немає, тож ви вибираєте клієнтський застосунок. В Oriveo OpenRouter — один із 15 вбудованих постачальників у групі «Агрегатори», тож адресу вводити не потрібно.

  • Відкрийте «Постачальники»: це вкладка на iPhone та Android або пункт бічної панелі у вебі.
  • Натисніть кнопку + («Додати постачальника») і виберіть OpenRouter. Фільтр «Агрегатори» звужує список.
  • Вставте ключ під заголовком «Підключити OpenRouter» і натисніть «Продовжити».
  • Дочекайтеся повідомлення «Перевірка з’єднання та синхронізація моделей...». Oriveo завантажить список моделей OpenRouter.
  • Виберіть модель і починайте спілкування. Якщо кредитів немає, вибирайте модель з ID, що закінчується на «:free».
Головний екран Oriveo: поле для повідомлення, під ним вибрана модель, а нижче сьогоднішні чати, кожен зі своєю вартістю
Після підключення ключа виберіть модель під полем для повідомлення. Біля кожного чату в списку видно його орієнтовну вартість.

Куди потрапляє мій ключ OpenRouter?

На iPhone та Android запити йдуть із пристрою безпосередньо до постачальника, а ключ зберігається в захищеному сховищі телефона (Keychain на iPhone, Keystore на Android). У вебверсії запити проходять через наскрізну передачу в реальному часі на сервері Oriveo: ключ використовується лише для цього запиту й не зберігається як запис акаунта, а BYOK-чати не зберігаються як журнали чатів. Хмарна синхронізація ключі не вивантажує. Щоб користуватися OpenRouter на другому пристрої, вставте ключ і там або створіть для нього окремий ключ.

Ви платите OpenRouter напряму за його цінами. Oriveo не додає жодної націнки.

Чому не працює ключ API OpenRouter?

На сторінці помилок OpenRouter (openrouter.ai/docs/api-reference/errors) пояснено, що означає кожен код. Найпоширеніші станом на 18 листопада 2026 року:

  • В Oriveo помилка 402 відображається як «Квоту постачальника вичерпано», а 429 — як «Перевищено ліміт запитів» у вебі або «Постачальник обмежив частоту запитів» на iPhone та Android.
  • Моделі немає у вашому списку: синхронізуйте список моделей ще раз і перевірте, чи OpenRouter досі її пропонує.
Чому не працює ключ API OpenRouter?
ПомилкаЩо означаєЩо робити
401 Invalid credentialsКлюч неправильний, вимкнений або видаленийСкопіюйте повний ключ ще раз або створіть новий
401 «this is not an OpenRouter API key»Ви вставили ключ іншого постачальникаВізьміть ключ на openrouter.ai/keys; він починається з sk-or-v1-
402 insufficient creditsУ вашого акаунта або в цього ключа закінчилися кредитиПоповніть кредити або збільште ліміт ключа; очікування не допоможе
403 ForbiddenЗапит заблоковано через дозволи, модерацію, захисне правило (guardrail) чи бюджетний лімітПеревірте налаштування й ліміти ключа або змініть повідомлення
429 rate limitedЗабагато запитів — для OpenRouter або для постачальника моделіЗачекайте й повторіть; для безкоштовних моделей звірте ліміти вище
502 або 503Модель або її постачальники зараз недоступніСпробуйте пізніше або виберіть іншу модель

OpenRouter чи ключі від кожного постачальника?

OpenRouter зручний, коли хочеться мати багато моделей з одним ключем і одним балансом. Ключ безпосередньо від постачальника, як-от OpenAI чи Anthropic, підійде, якщо вам потрібні власний акаунт і оплата саме в цього постачальника. Oriveo приймає обидва варіанти, тож OpenRouter можна тримати поруч із прямими ключами й перемикати моделі по черзі в тій самій розмові.

Поширені запитання

Чи безкоштовний OpenRouter?
Частково. Ключ безкоштовний, а моделі з ID, що закінчується на «:free», нічого не коштують у межах денних лімітів: станом на 18 листопада 2026 року це 50 запитів на день або 1000, якщо ви купили щонайменше 10 кредитів. Для інших моделей потрібні передплачені кредити.
Де отримати ключ API OpenRouter?
На openrouter.ai/keys після входу. Створіть ключ, дайте йому назву й скопіюйте повністю; він починається з «sk-or-v1-».
Чи є в OpenRouter застосунок для iPhone чи Android?
Власного мобільного чат-застосунку OpenRouter не випускає. Користуйтеся чат-застосунком, що приймає ключ OpenRouter: в Oriveo відкрийте «Постачальники», натисніть +, виберіть OpenRouter, вставте ключ і натисніть «Продовжити».
Що означає помилка OpenRouter 402?
Вашому акаунту або ключу, яким ви користуєтеся, бракує кредитів. Поповніть кредити в OpenRouter або збільште ліміт ключа, якщо ви його встановлювали, і спробуйте знову. Сама собою ця помилка не зникне.
Чому не працює ключ API OpenRouter?
Подивіться на номер помилки. 401 — ключ неправильний або це не ключ OpenRouter; 402 — немає кредитів; 429 — забагато запитів або вичерпано ліміт безкоштовних моделей. Кожен код докладно розібрано в нашому посібнику з помилок ключів API.
Який вигляд має ключ API OpenRouter?
Він починається з «sk-or-v1-», далі йдуть 64 літери й цифри — разом 73 символи. Якщо ваш ключ коротший, частина не скопіювалася.

Читайте також

Користуйтеся ключем OpenRouter на телефоні

Відкрийте вебверсію або завантажте Oriveo для iPhone чи Android, вставте ключ OpenRouter і перемикайтеся між моделями з орієнтовною вартістю кожної відповіді.

Ще немає ключа API? Почніть з Oriveo Free — ключ не потрібен.