# 🔄 Как включить реальный API DeepSeek

## Текущий режим: MOCK ✅

Сейчас приложение работает с **mock данными** (без реальных запросов к API).

Это означает:
- ✅ Все функции работают без интернета
- ✅ Не расходуется баланс DeepSeek
- ⚠️ Ответы не от AI, а заготовленные шаблоны

---

## Когда включить реальный API

### Шаг 1: Проверьте баланс DeepSeek

1. Зайдите на https://platform.deepseek.com/billing
2. Убедитесь что на счету есть средства (минимум $1-2)
3. Если баланс пуст - пополните счёт

### Шаг 2: Измените режим в коде

Откройте файл: `lib/core/deepseek_service.dart`

Найдите строку (примерно строка 12):
```dart
final bool useMockMode = true;
```

Измените на:
```dart
final bool useMockMode = false;
```

### Шаг 3: Перезапустите приложение

```bash
flutter run
```

---

## Как это работает

### Mock режим (useMockMode = true)
```
Запрос → DeepSeek Service → Mock данные → Ответ
         (без API запросов)
```

**Плюсы:**
- Быстро (без сетевых задержек)
- Бесплатно (не нужен API)
- Стабильно (всегда работает)

**Минусы:**
- Ответы не от AI
- Не адаптированы под контекст

### Реальный API (useMockMode = false)
```
Запрос → DeepSeek Service → DeepSeek API → AI ответ
         (реальный запрос)
```

**Плюсы:**
- Умные ответы от AI
- Адаптация под контекст
- Качественные описания

**Минусы:**
- Расходует токены (~$0.001-0.01 за запрос)
- Нужен интернет
- Медленнее (1-3 секунды)

---

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

После включения реального API, запустите тест:

```bash
dart run test_deepseek_api.dart
```

Если видите ✅ вместо ❌ - API работает!

---

##Fallback режим

Даже при `useMockMode = false`, если API запрос не прошёл (нет баланса, ошибка сети), 
сервис автоматически вернётся к mock данным.

В консоли увидите:
```
DeepSeek API Error: 402 - Insufficient Balance
⚠️ Используется mock режим как fallback
```

---

## Стоимость запросов

Примерные расходы на DeepSeek API:

| Действие | Токенов | Стоимость |
|----------|---------|-----------|
| Генерация подзадач | ~500 | $0.0001 |
| Приоритизация | ~100 | $0.00003 |
| Описание задачи | ~200 | $0.00006 |
| Планирование | ~1000 | $0.0003 |
| Mind-карта | ~1500 | $0.0004 |

**При $2 на счету** можно сделать примерно:
- 20,000 генераций подзадач
- 60,000 приоритизаций
- 5,000 mind-карт

---

## Рекомендации

### Для разработки и тестирования
Оставьте **mock режим** (`useMockMode = true`)
- Быстрее цикл разработки
- Не тратите токены

### Для продакшена
Включите **реальный API** (`useMockMode = false`)
- Пользователи получат AI функции
- Расходы минимальные

---

## Troubleshooting

### Ошибка 402: Insufficient Balance
```
1. Проверьте баланс: https://platform.deepseek.com/billing
2. Пополните счёт
3. Или верните useMockMode = true
```

### Ошибка 401: Invalid API Key
```
1. Проверьте что ключ в .env начинается с 'sk-'
2. Нет лишних пробелов
3. Ключ активен в Dashboard
```

### Ошибка сети
```
1. Проверьте интернет-соединение
2. DeepSeek может быть недоступен в вашем регионе
3. Сервис автоматически переключится на mock
```

---

**Готово! 🚀**