VPS для OpenRouter: как использовать сервер для работы с API

OpenRouter позволяет обращаться к разным языковым моделям через единый API. Для приложения это удобно: вместо отдельной интеграции с каждым провайдером используется один совместимый с OpenAI API интерфейс. OpenRouter сейчас предоставляет доступ к сотням моделей и автоматически маршрутизирует запросы между провайдерами.

Сам OpenRouter при этом не нужно устанавливать на VPS. Сервер используется для приложения, которое отправляет запросы в OpenRouter. Например, на VPS можно разместить Telegram-бота, веб-приложение, API-сервис или внутренний инструмент компании.

Такой вариант особенно полезен, когда приложение должно работать постоянно. Локальный компьютер для этого не нужен, а API-ключ OpenRouter можно хранить на сервере и не отдавать пользователю браузера.

Подготовка VPS

Если VPS только что создан, также стоит установить несколько базовых инструментов:

apt install curl git unzip -yCopy

curl пригодится для проверки API, git для загрузки проекта, а unzip часто нужен при установке зависимостей.

Если эти программы уже установлены, команда просто сообщит об этом. Повторно устанавливать их не требуется.

Получение API-ключа OpenRouter

Для работы приложения понадобится API-ключ OpenRouter. Создать его можно в панели OpenRouter на сайте https://openrouter.ai/workspaces/default/keys

Сам ключ имеет вид примерно:

sk-or-v1-...Copy

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

На VPS лучше использовать переменную окружения:

export OPENROUTER_API_KEY="ваш-ключ"Copy

Проверить её наличие можно так:

echo "$OPENROUTER_API_KEY"Copy

Если ключ отображается в терминале, переменная установлена.

Для постоянной работы приложения ключ лучше передавать через systemd, Docker Compose или другой механизм управления секретами. Не стоит записывать его в файл, который доступен через веб-сервер.

OpenRouter также рекомендует передавать API-ключ через переменную окружения.

Список доступных моделей можно найти на странице: https://openrouter.ai/models

Проверяем OpenRouter с VPS

До установки полноценного приложения можно проверить сам API.
Выполните:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/auto",
    "messages": [
      {
        "role": "user",
        "content": "Ппривет! Ты работаешь?"
      }
    ]
  }'Copy

OpenRouter использует OpenAI-совместимый API, поэтому для интеграции можно использовать знакомые SDK и инструменты. Базовый адрес API сейчас выглядит так:

https://openrouter.ai/api/v1Copy

Если запрос прошёл успешно, сервер получит JSON с ответом модели.

Если вместо ответа появляется ошибка, сначала смотрите её текст. Например, ошибка авторизации обычно указывает на проблему с API-ключом, а сетевые ошибки уже требуют проверки соединения с OpenRouter.

Подключение OpenRouter к приложению

После проверки API можно подключать OpenRouter непосредственно к своему проекту.
Например, Python-приложение может использовать OpenAI-совместимый клиент. Устанавливаем библиотеку:

pip install openaiCopy

Затем указываем адрес OpenRouter и API-ключ:

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"]
)

response = client.chat.completions.create(
    model="openrouter/auto",
    messages=[
        {
            "role": "user",
            "content": "Расскажи, зачем приложению нужен VPS."
        }
    ]
)

print(response.choices[0].message.content)Copy

Итог

VPS для OpenRouter нужен не для запуска самой нейросети. Его задача постоянно работать как сервер вашего приложения, которое обращается к OpenRouter через API.
Для небольшого проекта достаточно недорогого VPS без GPU.