Alexyz
f1e0f6b5ef
- Add complete server infrastructure with Gitea, API, PostgreSQL - Implement Obsidian-compatible markdown mindmap converter - Add Flutter service for server synchronization - Configure GitHub Actions for automated build and deploy - Add production docker-compose with health checks - Include VPS setup and deployment scripts - Add comprehensive deployment documentation
163 lines
4.4 KiB
Markdown
163 lines
4.4 KiB
Markdown
# 🔄 Как включить реальный 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
|
||
```
|
||
|
||
---
|
||
|
||
**Готово! 🚀**
|