---
name: "ai-integrations"
description: "Manages AI provider workflows and model selection. Invoke when working with OpenAI/Anthropic/Google/DeepSeek/xAI or AI endpoints."
---

# AI‑интеграции и модели

## Протокол работы (обязательно)
- Сначала дай короткий план (1–3 шага): какие файлы/эндпоинты тронешь.
- Если есть неоднозначность — задай вопросы (провайдер, ключи, режим работы).
- Перед изменением кода — получи подтверждение (особенно для крупных правок).
- Если в промпте явно просят выполнить команды/проверки — запускай в терминале без дополнительных вопросов.
- Если пользователь просит только план — остановись на плане.

## Назначение
Обеспечивает корректную работу AI‑провайдеров, моделей, ключей и эндпоинтов в сервере и клиенте.

## Когда вызывать
- Любые изменения AI‑эндпоинтов /api/ai/* или /api/models/*.
- Подключение нового провайдера или модели.
- Диагностика ошибок ключей, лимитов и несовместимых моделей.
- Изменения YouTube транскрипции или форматирования текста.

## Правила провайдеров
- Подписка: серверные ключи через ENV.
- Пользовательские ключи: только client + expo-secure-store.
- Транскрипция YouTube: только OpenAI (или подписка).
- Форматирование и генерация: Anthropic Claude через сервер.
- Учитывать режимы: транскрипция, анализ, генерация, форматирование.
 - Пользовательские ключи не сохранять и не логировать на сервере; передавать только когда этого требует конкретный endpoint.

## Контроль моделей
- Whisper: gpt-4o-mini-transcribe (подписка) или whisper-1 (свой ключ).
- Форматирование/генерация: claude-sonnet-4-5.
- Обложки: gpt-image-1 через сервер.
- Проверять соответствие модели провайдеру.
- Валидировать фильтры выдачи моделей.
- Явно фиксировать базовую модель по умолчанию.

## Ключевые эндпоинты
- /api/ai/analyze, /api/ai/analyze-multi, /api/ai/generate.
- /api/youtube/transcript, /api/youtube/transcribe.
- /api/models/:provider, /api/validate-key, /api/subscription/status.

## Обработка ошибок
- Возвращать понятные ошибки для клиента.
- Не скрывать корневую причину при невалидном ключе/модели.
- Проставлять корректные HTTP статусы.

## Правила коммуникации
- Использовать простой русский язык.
- Перед крупными изменениями получить подтверждение.

## Выход
- Список затронутых провайдеров/моделей.
- Рекомендации по корректной конфигурации.