Avtex/MOCK_VS_REAL_API.md

🔄 Как включить реальный 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):

final bool useMockMode = true;

Измените на:

final bool useMockMode = false;

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

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, запустите тест:

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

---

Готово! 🚀