Содержание

1. Где в кабинете находятся API-ключи

2. Параметры нового ключа

3. Создание и копирование ключа

4. Как удалить ключ

5. Guardrails: какие модели доступны ключу

6. Что дальше

Чтобы начать работать с API OpenRouter из своих скриптов, нужен API-ключ. В коротком видео показано, где его сгенерировать в кабинете OpenRouter, какие параметры задать при создании и как ограничить ключ, чтобы он не потратил лишнего. Если вы ещё не знаете, зачем нужен сам сервис, начните с урока «OpenRouter (опенроутер): что это и как пользоваться».

Где в кабинете находятся API-ключи

Войдите в аккаунт OpenRouter и откройте раздел Dashboard. В левом меню есть пункт «API-ключи» (Keys). Здесь отображается список всех ключей вашего аккаунта. Чтобы создать новый, нажмите кнопку New.

Параметры нового ключа

  • Имя. Произвольное, лучше латинскими буквами. Удобно держать отдельные ключи под разные задачи: например, main для основной работы, отдельный ключ для преобразования речи в текст и тестовый ключ test-1.
  • Срок действия (expiration). Можно задать, сколько ключ будет жить: 1 час, 7 дней и так далее. По истечении срока он перестанет работать. Если ограничение не нужно, выберите вариант «без истечения срока действия».
  • Кредитный лимит. Сколько денег выделено на этот ключ. Когда сумма закончится, ключ перестаёт быть рабочим. Лимит страхует от неожиданных расходов: вы не выйдете за пределы бюджета и не уйдёте в минус по балансу аккаунта. Поставьте сумму в долларах, которую готовы выделить ключу, например 5 долларов. Когда лимит израсходуется, ключ можно удалить и выпустить заново.
  • Сброс лимита. Можно выбрать, как часто лимит обнуляется: каждый день, каждую неделю, каждый месяц и так далее.

Создание и копирование ключа

Нажмите Create. OpenRouter покажет сам ключ, его нужно сразу скопировать кнопкой рядом с ним. Дальше вы подставляете его в свои скрипты и программы. Перед генерацией сервис может запросить код подтверждения, что действие выполняете именно вы.

Ключ показывается один раз, поэтому сохраните его в надёжном месте. Не публикуйте ключ в открытом репозитории и не вставляйте в код, который кому-то отправляете: в скриптах обычно берут его из переменной окружения.

Как удалить ключ

Если ключ больше не нужен, либо вы поняли, что он утёк к посторонним или с ним происходят несанкционированные действия, его можно удалить в том же списке. После удаления пользоваться им уже нельзя.

Guardrails: какие модели доступны ключу

В настройках есть раздел Guardrails. Он позволяет гибко управлять тем, что ключу разрешено и что запрещено: какие модели и сервисы будут ему доступны, а какие нет. Для этого в настройках ключа выберите нужные ограничения. Так вы можете выдать отдельному скрипту ключ только под одну недорогую модель.

Что дальше

Когда ключ получен, переходите к уроку «Модели OpenRouter: подключение через API, SDK и библиотеку OpenAI»: там показано, как с этим ключом обратиться к модели из Python через библиотеку OpenAI. Этот урок входит в курс «Основы работы с AI для программистов», а он, в свою очередь, - в программу «AI инжиниринг».