# 🚀 Инструкция по настройке OpenRouter для Qwen
## 🎯 Что такое OpenRouter?
**OpenRouter** - это универсальный API-шлюз для доступа к различным AI моделям, включая все модели Qwen.
**Преимущества:**
- ✅ **Простая регистрация** - без сложной верификации
- ✅ **Глобальная доступность** - работает везде
- ✅ **OpenAI-совместимый API** - легко интегрировать
- ✅ **Бесплатный tier** - есть бесплатные кредиты
- ✅ **Все модели Qwen** - turbo, plus, max
---
## 🚀 Быстрый старт (5 минут)
### ШАГ 1: Регистрация на OpenRouter
1. **Откройте:** https://openrouter.ai/
2. **Нажмите:** "Sign In" или "Get Started"
3. **Войдите через:**
- Google аккаунт (самый простой способ)
- Или создайте аккаунт с email
### ШАГ 2: Получение API ключа
1. После входа найдите раздел **"Keys"** в меню
2. Или перейдите напрямую: https://openrouter.ai/keys
3. Нажмите **"Create Key"**
4. Введите название (например: "Trader Agent")
5. **Скопируйте ключ** (формат: `sk-or-v1-...`)
- ⚠️ Ключ показывается только один раз!
### ШАГ 3: Активируйте бесплатные кредиты (опционально)
1. Перейдите в раздел **"Credits"**: https://openrouter.ai/credits
2. Если есть бесплатные кредиты - они активируются автоматически
3. Или пополните баланс (минимум $5)
### ШАГ 4: Протестируйте
```bash
export QWEN_API_KEY="sk-or-v1-ваш-ключ"
cd /Users/Gyber/GYBERNATY-ECOSYSTEM/TRADER-AGENT
source venv/bin/activate
python test_qwen_simple.py
```
---
## 📋 Доступные модели Qwen на OpenRouter
| Модель | Название в API | Описание | Цена |
|--------|----------------|----------|------|
| **Qwen Turbo** | `qwen/qwen-turbo` | Быстрая, дешёвая | $0.10 / 1M tokens |
| **Qwen Plus** | `qwen/qwen-plus` | Сбалансированная | $0.20 / 1M tokens |
| **Qwen Max** | `qwen/qwen-max` | Самая мощная | $0.50 / 1M tokens |
**Рекомендация:** Начните с `qwen/qwen-turbo` - она самая дешёвая и быстрая.
---
## 🔧 Настройка переменных окружения
### Локально:
```bash
export QWEN_API_KEY="sk-or-v1-ваш-ключ"
export QWEN_MODEL="qwen/qwen-turbo" # Опционально
```
### В GitHub Secrets (для Kubernetes):
1. Перейдите в GitHub репозиторий
2. **Settings** → **Secrets and variables** → **Actions**
3. Добавьте или обновите:
- `QWEN_API_KEY` = `sk-or-v1-ваш-ключ`
- `QWEN_MODEL` = `qwen/qwen-turbo` (опционально)
---
## ✅ Проверка работы
### Тест 1: Простой запрос
```bash
export QWEN_API_KEY="sk-or-v1-ваш-ключ"
python test_qwen_simple.py
```
**Ожидаемый результат:**
```
✅ УСПЕХ!
📥 Ответ: [ответ от модели]
```
### Тест 2: Полный анализ рынка
```bash
python -m autonomous_agent.main
```
**Ожидаемый результат:**
- Анализ рынка выполнен
- Найдены топ 3 возможности
- Результаты сохранены в `data/latest_analysis.json`
---
## 💰 Цены и лимиты
### Бесплатный tier:
- Обычно даётся $5-10 бесплатных кредитов при регистрации
- Достаточно для тестирования
### Платные планы:
- Pay-as-you-go (плати за использование)
- Минимальное пополнение: $5
- Цены очень низкие (от $0.10 за 1M tokens)
### Проверка баланса:
1. Откройте: https://openrouter.ai/credits
2. Посмотрите текущий баланс
3. При необходимости пополните
---
## 🆘 Решение проблем
### Проблема: "401 Unauthorized"
**Решение:**
- Проверьте что API ключ правильный (начинается с `sk-or-v1-`)
- Убедитесь что нет лишних пробелов
- Создайте новый ключ если нужно
### Проблема: "402 Payment Required" / "Insufficient credits"
**Это означает:** На аккаунте нет баланса
**Решение:**
👉 **Подробная инструкция:** [`OPENROUTER_CREDITS_FIX.md`](OPENROUTER_CREDITS_FIX.md)
**Кратко:**
1. Откройте: https://openrouter.ai/settings/credits
2. Нажмите "Add Credits" или "Purchase Credits"
3. Пополните минимум $5-10
4. Подождите 1-2 минуты
5. Попробуйте снова
### Проблема: "404 Model not found"
**Решение:**
- Проверьте название модели (должно быть `qwen/qwen-turbo`, не `qwen-turbo`)
- Используйте правильный формат: `qwen/qwen-turbo`, `qwen/qwen-plus`, `qwen/qwen-max`
### Проблема: "429 Rate limit exceeded"
**Решение:**
- Подождите несколько минут
- Или пополните баланс для увеличения лимитов
---
## 📚 Дополнительные ресурсы
- **OpenRouter:** https://openrouter.ai/
- **Документация:** https://openrouter.ai/docs
- **Модели Qwen:** https://openrouter.ai/models?q=qwen
- **API Reference:** https://openrouter.ai/docs/api-reference
---
## 🎯 Преимущества перед DashScope/Bailian
| Параметр | OpenRouter | DashScope/Bailian |
|----------|------------|-------------------|
| **Регистрация** | ✅ Простая (через Google) | ❌ Сложная верификация |
| **Доступность** | ✅ Глобальная | ❌ Региональные ограничения |
| **API формат** | ✅ OpenAI-совместимый | ❌ Свой формат |
| **Бесплатный tier** | ✅ Есть | ⚠️ Требует верификацию |
| **Модели Qwen** | ✅ Все доступны | ⚠️ Могут быть недоступны |
---
## ✅ Чеклист готовности
- [ ] Зарегистрирован на openrouter.ai
- [ ] Создан API ключ (sk-or-v1-...)
- [ ] Баланс > 0 (или есть бесплатные кредиты)
- [ ] Переменная `QWEN_API_KEY` установлена
- [ ] Тест `test_qwen_simple.py` проходит успешно
---
## 🚀 После настройки
Когда всё заработает:
1. **Обновите GitHub Secrets:**
- `QWEN_API_KEY` = ваш ключ от OpenRouter
- `QWEN_MODEL` = `qwen/qwen-turbo` (опционально)
2. **Запустите полный тест:**
```bash
python -m autonomous_agent.main
```
3. **Проверьте публикацию в Telegram:**
- Убедитесь что `TELEGRAM_BOT_TOKEN` и `TELEGRAM_CHAT_IDS` установлены
- Проверьте что сообщения приходят в канал
---
**Готово! OpenRouter намного проще чем DashScope/Bailian! 🎉**