OpenRouter API на VPS: получение API-ключа, установка Python и первый запуск

OpenRouter это агрегатор AI-моделей, который даёт доступ к более чем 300 моделям через один API-ключ и один эндпоинт.

Claude, GPT, Gemini, Llama, DeepSeek, Mistral и десятки других доступны через единый интерфейс, совместимый с OpenAI SDK.

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

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

Регистрация и получение API-ключа

1. Перейдите на openrouter.ai/
2. Зарегистрируйтесь через email или Google-аккаунт
3. Откройте раздел Keys → Create Key
4. Скопируйте ключ.

Регистрация бесплатная, карта не нужна.

Бесплатный уровень даёт доступ к 20+ моделям с ограничением 20 запросов в минуту и 200 запросов в день.

После пополнения баланса на $10 лимит вырастает до 1000 запросов в день.

Системные требования

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

Задача	CPU	RAM
Скрипты и автоматизация	1 vCPU	1 ГБ
Telegram-бот	1 vCPU	1–2 ГБ
API-сервис или прокси	1–2 vCPU	2–4 ГБ
Несколько сервисов	2 vCPU	4 ГБ

Подключение к серверу

Подключитесь к серверу

ssh root@IP_СЕРВЕРАCopy

Обновите систему:

apt update && apt upgrade -yCopy

Проверка работы

После подключения к VPS проверьте доступность одной командой:

curl -s https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer ваш-ключ" | head -c 200Copy

Если в ответ пришёл JSON из доступных моделей, то значит VPS подходит для работы с OpenRouter. Если вернулась ошибка, например

Error 403: Access denied by security policy.Copy

То прочитайте статью - OpenRouter - ошибка 403

Пример запроса с VPS litnets.com - вернулся список моделей, значит сервер подходит.

Установка Python и зависимостей

Установите Python и venv, если они ещё не установлены

apt install python3 python3-pip python3-venv -yCopy

Создайте рабочую папку и виртуальное окружение, если у вас их ещё нет.

Если у вас уже есть папка проекта и виртуальное окружение, то активируйте его и установите.

mkdir openrouter-app && cd openrouter-app
python3 -m venv venv
source venv/bin/activateCopy

Установите OpenAI SDK

pip install openaiCopy

Первый запрос

Не храните ключ в коде. Это не безопасно и не удобно, если ключ потребуется изменить.

Сохраните ключ в переменную окружения:

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

Чтобы сохранялся после перезагрузки:

echo 'export OPENROUTER_API_KEY="ваш-ключ"' >> ~/.bashrc
source ~/.bashrcCopy

Создайте файл test.py:

nano test.pyCopy

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="google/gemma-4-26b-a4b-it:free",
    messages=[
        {"role": "user", "content": "Объясни в двух предложениях, что такое VPS."}
    ]
)

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

google/gemma-4-26b-a4b-it:free - модель для теста

Список бесплатных моделей OpenRouter: https://openrouter.ai/models?output_modalities=text&order=pricing-low-to-high

Сохраните и запустите:

python3 test.pyCopy

Если все настроено правильно, то вы увидите ответ

Если возникает ошибка, например Error 403: Access denied by security policy., то разобрали что делать в статье: OpenRouter - ошибка 403

Переключение между моделями

Чтобы сменить модель, достаточно изменить одну строку:

# Бесплатные модели (суффикс :free)
model="google/gemma-4-31b-it:free"
model="openai/gpt-oss-20b:free"

# Платные модели
model="anthropic/claude-sonnet-4.5"
model="openai/gpt-5.6-sol-pro"
model="google/gemini-2.5-pro"

# Автовыбор из доступных бесплатных моделей
model="openrouter/auto"Copy

Актуальный список моделей всегда доступен на openrouter.ai/models, там можно фильтровать по цене, провайдеру и возможностям.

Для того что бы проверить, подходит ли модель, можно использовать Playground прямо на сайте.

Нажмите на нужную модель -> Playground -> Проверьте работу

Пример: чат с историей

import os
from openai import OpenAI

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

history = [
    {"role": "system", "content": "Отвечай кратко."}
]

while True:
    user_input = input("Вы: ")
    if user_input.lower() in ("exit", "quit"):
        break

    history.append({"role": "user", "content": user_input})

    response = client.chat.completions.create(
        model="meta-llama/llama-3.3-70b-instruct:free",
        messages=history
    )

    reply = response.choices[0].message.content
    history.append({"role": "assistant", "content": reply})
    print(f"Ассистент: {reply}")Copy

Пример: автоматический выбор модели с fallback

OpenRouter умеет автоматически переключаться на резервную модель если основная недоступна:

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Привет!"}],
    extra_body={
        "route": "fallback",
        "models": [
            "anthropic/claude-sonnet-4-5",
            "openai/gpt-4o",
            "meta-llama/llama-3.3-70b-instruct"
        ]
    }
)Copy

Это удобно для продакшн-сервисов где важна надёжность.

Запуск в фоне

Для того что бы сервис не "падал" при закрытии SSH сессии, удобно его запустить через screen или systemd. Для продакшена рекомендуется systemd.

Вариант 1. через screen:

apt install screen -y
screen -S openrouter
source venv/bin/activate
python3 your_script.py
# Ctrl+A, затем D — выйти, скрипт остаётся работатьCopy

Вариант 2. через systemd:

Создайте /etc/systemd/system/openrouter-app.service:

nano /etc/systemd/system/openrouter-app.serviceCopy

[Unit]
Description=OpenRouter App
After=network.target

[Service]
WorkingDirectory=/root/openrouter-app # замените на папку вашего проекта
ExecStart=/root/openrouter-app/venv/bin/python3 your_script.py # замените на путь до вашего проекта
Restart=always
Environment=OPENROUTER_API_KEY=ваш_ключ # замените на ваш ключ

[Install]
WantedBy=multi-user.targetCopy

Включите сервис:

systemctl daemon-reload
systemctl enable openrouter-app
systemctl start openrouter-app
systemctl status openrouter-appCopy

Зачем использовать OpenRouter на VPS

• На VPS можно запускать Telegram-ботов и скрипты, которые должны работать и быть доступными 24/7
• Можно сравнивать модели и переключаться между ними без изменения кода
• Строить приложения с fallback-логикой, если одна модель недоступна, автоматически переключаться на другую
• Использовать бесплатные модели для прототипирования без вложений
• Держать один ключ вместо десятка от разных провайдеров.
• VDS в Нидерландах подходят для доступа к OpenRouter без региональных ограничений.

Бесплатные модели OpenRouter

Бесплатные модели на OpenRouter имеют суффикс :free в названии и доступны без пополнения баланса.

Актуальный список можно найти на openrouter.ai/models с фильтром Pricing: Low to Hight

https://openrouter.ai/models?output_modalities=text&order=pricing-low-to-high

Что можно установить ещё

На VPS можно устанавливать любое ПО, без ограничений.

Например:

• python-telegram-bot для Telegram-ботов
• FastAPI для собственного API поверх OpenRouter
• n8n автоматизации через HTTP-запросы к OpenRouter
• Cron запуск скриптов по расписанию

Безопасность

• Храните ключ только в переменных окружения, не в коде
• Добавьте .env в .gitignore если используете файл окружения
• Следите за балансом в личном кабинете OpenRouter
• Настройте лимиты расходов в разделе Settings → Limits

Заключение

OpenRouter убирает необходимость поддерживать несколько интеграций при работе с API. Он выпускает один ключ на более чем 300 моделей и позволяет быстро переключаться между ними.

Настройка на VPS позволяет настроить постоянно работающий сервис, доступный из любой точки мира.