README_DASHSCOPE.md•7.87 kB
# 📚 Qwen API - Все инструкции в одном месте
## 🚀 РЕКОМЕНДУЕТСЯ: OpenRouter (Самое простое решение!)
**После проблем с DashScope/Bailian, мы перешли на OpenRouter:**
👉 **Начните здесь:** [`README_OPENROUTER.md`](README_OPENROUTER.md)
**Почему OpenRouter:**
- ✅ Простая регистрация (через Google)
- ✅ Глобальная доступность
- ✅ Все модели Qwen доступны
- ✅ OpenAI-совместимый API
- ✅ Бесплатный tier
**Быстрый старт:**
1. Зарегистрируйтесь: https://openrouter.ai/
2. Получите ключ: https://openrouter.ai/keys
3. Установите: `export QWEN_API_KEY="sk-or-v1-ваш-ключ"`
4. Протестируйте: `python test_qwen_simple.py`
---
## ⚠️ Альтернативные варианты (если нужны)
### Вариант Б: Bailian (для международных пользователей)
**Если OpenRouter не подходит:**
👉 [`BAILIAN_SETUP_GUIDE.md`](BAILIAN_SETUP_GUIDE.md)
### Вариант В: DashScope (только для Китая)
**Только для пользователей из Китая (aliyun.com):**
👉 [`DASHSCOPE_QUICK_START.md`](DASHSCOPE_QUICK_START.md)
---
## 📖 Подробная инструкция (15 минут)
**Для детального изучения:** 👉 [`DASHSCOPE_SETUP_GUIDE.md`](DASHSCOPE_SETUP_GUIDE.md)
Полная пошаговая инструкция со всеми деталями и решениями проблем.
---
## 🖼️ Визуальный гайд (10 минут)
**С прямыми ссылками:** 👉 [`DASHSCOPE_VISUAL_GUIDE.md`](DASHSCOPE_VISUAL_GUIDE.md)
Визуальное руководство с прямыми ссылками на все нужные разделы консоли.
---
## 🎯 Что нужно сделать (кратко)
### ⚠️ ВАЖНО: DashScope недоступен на alibabacloud.com!
**Для международных пользователей используйте Bailian:**
### Вариант А: Bailian (РЕКОМЕНДУЕТСЯ для международных пользователей)
### 1. Откройте Bailian Console
👉 **https://bailian.console.alibabacloud.com/?tab=api#/api**
### 2. Создайте API ключ
- Войдите в систему
- Найдите раздел **"API"**
- Нажмите **"Create API Key"**
- Скопируйте ключ (формат: `sk-...`)
### 3. Активируйте доступ
- Перейдите в раздел **"Billing"**
- Активируйте Free Tier или пополните баланс
- Подождите 5-10 минут
---
### Вариант Б: DashScope (Только для пользователей из Китая)
### 1. Регистрация
👉 https://dashscope.console.aliyun.com/ (aliyun.com, НЕ alibabacloud.com!)
### 2. Создать API ключ
👉 https://dashscope.console.aliyun.com/apiKey
- Нажмите "Create API Key"
- Скопируйте ключ (формат: `sk-...`)
### 3. Активировать доступ
👉 https://dashscope.console.aliyun.com/billing
- Активируйте Free Tier ИЛИ пополните баланс ($5-10)
- Подождите 5-10 минут
### 4. Проверить модель
👉 https://dashscope.console.aliyun.com/models
- Убедитесь что `qwen-turbo` доступна
---
### Вариант Б: Bailian (Альтернатива)
👉 **Подробная инструкция:** [`BAILIAN_SETUP_GUIDE.md`](BAILIAN_SETUP_GUIDE.md)
**Быстрый старт:**
1. Откройте: https://bailian.console.alibabacloud.com/?tab=api#/api
2. Создайте API ключ
3. Активируйте доступ (Free Tier или пополните баланс)
4. Используйте тот же код - API endpoint одинаковый!
---
### 5. Протестировать (для обоих вариантов)
```bash
export QWEN_API_KEY="sk-ваш-ключ"
python test_qwen_simple.py
```
---
## ❓ Какую инструкцию выбрать?
| Ваша ситуация | Читайте |
|---------------|---------|
| **Хочу самое простое решение** | `README_OPENROUTER.md` 🚀 **РЕКОМЕНДУЕТСЯ!** |
| Вижу сообщение "DashScope not released on alibabacloud.com" | `IMPORTANT_DASHSCOPE_UNAVAILABLE.md` ⚠️ |
| Вижу ошибку "Account abnormal" / "NO_REAL_REGISTER_AUTHENTICATION" | `ACCOUNT_AUTHENTICATION_FIX.md` 🔐 |
| Международный пользователь (alibabacloud.com) | `OPENROUTER_SETUP_GUIDE.md` ✅ или `BAILIAN_SETUP_GUIDE.md` |
| Пользователь из Китая (aliyun.com) | `DASHSCOPE_QUICK_START.md` |
| Хочу понять всё детально | `OPENROUTER_SETUP_GUIDE.md` или `BAILIAN_SETUP_GUIDE.md` |
| Не могу найти разделы в консоли | `DASHSCOPE_VISUAL_GUIDE.md` |
| Возникла ошибка | `OPENROUTER_SETUP_GUIDE.md` → Решение проблем |
---
## ⚠️ Самая частая проблема
**Ошибка:** `403 AccessDenied.Unpurchased`
**Причина:** Нет доступа к моделям (нужен баланс или Free Tier)
**Решение:**
1. Откройте: https://dashscope.console.aliyun.com/billing
2. Активируйте Free Tier ИЛИ пополните баланс
3. Подождите 5-10 минут
4. Попробуйте снова
---
## ✅ Чеклист готовности
- [ ] Зарегистрирован на dashscope.console.aliyun.com
- [ ] Создан API ключ (sk-...)
- [ ] Баланс > 0 ИЛИ Free Tier активирован
- [ ] Модель qwen-turbo доступна
- [ ] Тест `test_qwen_simple.py` проходит успешно
---
## 🆘 Нужна помощь?
1. **Прочитайте инструкции выше** - там ответы на 90% вопросов
2. **Проверьте раздел "Решение проблем"** в `DASHSCOPE_SETUP_GUIDE.md`
3. **Откройте тикет поддержки** в консоли DashScope
4. **Напишите мне** - помогу разобраться!
---
## 📁 Все файлы инструкций
```
TRADER-AGENT/
├── README_DASHSCOPE.md ← Вы здесь (обзор всех инструкций)
├── README_OPENROUTER.md ← 🚀 РЕКОМЕНДУЕТСЯ! Начните отсюда!
├── OPENROUTER_SETUP_GUIDE.md ← ✅ Подробная инструкция OpenRouter
├── IMPORTANT_DASHSCOPE_UNAVAILABLE.md ← ⚠️ DashScope недоступен на alibabacloud.com
├── ACCOUNT_AUTHENTICATION_FIX.md ← 🔐 Ошибка "Account abnormal" - решение
├── BAILIAN_SETUP_GUIDE.md ← Альтернатива: Bailian для международных пользователей
├── DASHSCOPE_QUICK_START.md ← Альтернатива: DashScope (только для Китая)
├── DASHSCOPE_SETUP_GUIDE.md ← Подробная инструкция DashScope
├── DASHSCOPE_VISUAL_GUIDE.md ← Визуальный гайд DashScope
├── QWEN_API_ISSUE.md ← Описание проблемы с API
└── TESTING_REPORT.md ← Отчёт о тестировании
```
---
**Удачи! 🚀**
Начните с `DASHSCOPE_QUICK_START.md` - это самый быстрый путь!