API ключи
Цель
Настроить API ключи для интеграции с AI провайдерами (OpenRouter, Segmind, Gemini).
Предусловия
- Права администратора
- Аккаунты у соответствующих провайдеров
Обзор провайдеров
| Провайдер | Функционал | Сайт |
|---|---|---|
| OpenRouter | Текстовые AI модели (DeepSeek, Claude, GPT) | openrouter.ai |
| Segmind | Генерация и редактирование изображений | segmind.com |
| Gemini | Текст + изображения от Google | ai.google.dev |
Настройка OpenRouter
Получение API ключа
- Зарегистрируйтесь на openrouter.ai
- Перейдите в Keys → Create Key
- Назовите ключ (например, «SMAIWER Production»)
- Скопируйте ключ (начинается с
sk-or-...)
Добавление в SMAIWER
- Откройте Настройки → AI → API ключи
- В разделе OpenRouter нажмите «Добавить ключ»
- Вставьте ключ
- Нажмите «Сохранить»
Выбор моделей
После добавления ключа станут доступны модели:
| Модель | Описание | Стоимость |
|---|---|---|
| DeepSeek Chat | Быстрая, экономичная | ~$0.001/1K токенов |
| Claude 3 Haiku | Быстрая, качественная | ~$0.003/1K токенов |
| Claude 3 Sonnet | Сбалансированная | ~$0.015/1K токенов |
| Claude 3 Opus | Максимальное качество | ~$0.075/1K токенов |
| GPT-4 Turbo | OpenAI флагман | ~$0.030/1K токенов |
Настройка Segmind
Получение API ключа
- Зарегистрируйтесь на segmind.com
- Перейдите в Settings → API Keys
- Нажмите «Generate API Key»
- Скопируйте ключ
Добавление в SMAIWER
- Настройки → AI → API ключи
- В разделе Segmind нажмите «Добавить ключ»
- Вставьте ключ
- Сохраните
Доступные функции
После добавления ключа:
- ✅ Генерация изображений (SDXL, Flux)
- ✅ Редактирование (Upscale, Background Removal)
- ✅ Face Swap
- ✅ PixelFlows (60+ шаблонов)
Проверка баланса
Баланс кредитов отображается в Настройки → AI → Segmind:
Баланс: 1,250 кредитов
Использовано сегодня: 45 кредитов
Настройка Gemini
Получение API ключа
- Перейдите на ai.google.dev
- Нажмите «Get API Key»
- Создайте проект или выберите существующий
- Скопируйте ключ
Добавление в SMAIWER
- Настройки → AI → API ключи
- В разделе Gemini нажмите «Добавить ключ»
- Вставьте ключ
- Сохраните
Особенности Gemini
- ✅ Бесплатный лимит (60 запросов/минуту)
- ✅ Хорошо понимает русский язык
- ✅ Поддержка изображений (анализ и генерация)
Глобальные vs Локальные ключи
Глобальные ключи
Устанавливаются супер-администратором для всех организаций:
Преимущества:
- Централизованное управление
- Общий биллинг
- Не требует настройки от пользователей
Используется когда:
- Ключи не настроены организацией
Локальные ключи
Устанавливаются администратором организации:
Преимущества:
- Собственный биллинг
- Независимость от платформы
- Контроль расходов
Приоритет:
- Если настроен локальный ключ, он используется первым
Безопасность ключей
Шифрование
Все API ключи шифруются перед сохранением в базе данных (Fernet encryption).
Ротация ключей
Рекомендуется менять ключи:
- При подозрении на утечку
- При увольнении сотрудников с доступом
- Каждые 90 дней (опционально)
Проверка использования
- Настройки → AI → Логи
- Просмотрите историю запросов
- Отслеживайте аномальное использование
Лимиты и квоты
Настройка лимитов
Установите ограничения для контроля расходов:
| Параметр | Описание |
|---|---|
| Дневной лимит | Максимум запросов в день |
| Лимит на пользователя | Запросов на одного оператора |
| Лимит стоимости | Максимальные расходы в день |
Уведомления
Настройте оповещения:
- ⚠️ 80% от лимита
- 🔴 100% от лимита (блокировка)
- 📧 Ежедневный отчёт
Решение проблем
Ключ не работает
- Проверьте правильность копирования
- Убедитесь, что ключ активен у провайдера
- Проверьте баланс/лимиты
Ошибка авторизации
Error: Invalid API key or authentication failed
Решение: Пересоздайте ключ у провайдера.
Превышен лимит
Error: Rate limit exceeded
Решение: Подождите или увеличьте план у провайдера.