Диагностика и частые ошибки
FOXI Studio работает в облаке, поэтому большинство проблем диагностируется не через локальные папки и системные настройки компьютера, а через Dashboard, журнал событий, баланс FX, файлы проекта и AI-помощник.
Если что-то не запустилось, остановилось или дало странный результат, не нажимайте кнопки много раз подряд. Сначала откройте журнал и посмотрите последние сообщения: обычно там видно, какой шаг выполнялся, где возникла ошибка и что нужно проверить.

Быстрый порядок диагностики
Используйте этот порядок почти для любой ошибки:
- Проверьте, выбран ли правильный проект.
- Посмотрите, есть ли темы в очереди.
- Откройте нижний журнал событий.
- Проверьте баланс FX и hold средств.
- Проверьте, доступна ли функция на вашем тарифе.
- Откройте Файлы проекта и убедитесь, что нужный результат действительно создан.
- Если текст ошибки непонятен, отправьте его AI-помощнику.

Как читать журнал событий
Журнал показывает, что делает FOXI: сохранение настроек, запуск этапа, ожидание ответа модели, скачивание файлов, рендер, публикация и ошибки.

Смотрите не только последнюю строку, но и несколько строк выше. Часто настоящая причина находится перед финальным сообщением об ошибке.
Полезные признаки:
- ошибка сразу после запуска — проверьте тариф, баланс, проект и обязательные настройки;
- ошибка после долгого ожидания — возможен таймаут модели или внешнего сервиса;
- ошибка на конкретном шаге — откройте настройки этого шага;
- нет новых строк — возможно, задача ещё не стартовала или интерфейс ждёт ответа сервера;
- много retry — проверьте лимиты, паузы, параллельность и стабильность провайдера.
AI-помощник для диагностики
AI-помощник может объяснить ошибку простыми словами, потому что видит контекст текущего проекта и настройки.

Хороший запрос:
Посмотри последние ошибки в журнале проекта. Объясни простыми словами, что сломалось, какой шаг проверить и какие настройки изменить. Не переписывай промпты без моего подтверждения.
Если ошибка связана с расходами, можно спросить:
Посмотри расходы и hold проекта. Почему задача не стартует или почему ролик стал дорогим?
Недостаточно FX или средства в hold
Если задача не стартует или останавливается перед генерацией, проверьте баланс.

Возможные причины:
- FX закончились;
- часть FX заморожена на другой активной задаче;
- задача требует большего резерва, чем доступно;
- предыдущая задача ещё не завершила возврат hold;
- выбран дорогой режим: много AI-видео, 4K Builder, аватар, Anti-Detect.
Что сделать:
- Откройте Токены и расходы.
- Посмотрите доступно/заморожено.
- Проверьте, нет ли активной задачи.
- Уменьшите дорогие настройки или пополните FX.
- Повторите запуск только после понимания причины.
Функция недоступна на тарифе
Некоторые возможности могут зависеть от тарифа: Scout, Analytics, YouTube upload, WordPress, Anti-Detect, длинные видео, количество проектов или параллельные процессы.

Если кнопка неактивна или появляется сообщение о лимите:
- проверьте статус тарифа;
- откройте кабинет;
- сравните доступные функции;
- не пытайтесь обходить ограничение повторными кликами;
- спросите AI-помощника, какой тариф нужен для конкретной функции.
Очередь тем пустая
Полный цикл не может создать ролик, если не знает тему. Проверьте левую панель и очередь тем.

Что сделать:
- добавьте тему вручную;
- запустите YouTube Scout;
- проверьте, не была ли тема удалена после успешного финального шага;
- убедитесь, что выбран правильный проект.
Результат не появился в файлах проекта
Иногда этап завершился, но пользователь смотрит не тот проект, не ту задачу или ожидает файл не в той секции.

Проверьте:
- выбран правильный проект;
- открыты Файлы проекта именно текущего задания;
- этап действительно завершился в журнале;
- файл не находится в другой секции: изображения, клипы, финальные видео, тексты, ассеты;
- не истёк срок хранения материалов.
Если файл важен, скачивайте его после проверки. Материалы в облаке могут храниться ограниченное время.
Ошибки YouTube API keys
YouTube API keys используются для Scout и анализа публичных данных. Ошибки вида quota, limit, 403, 429 или API disabled обычно относятся к ключам или квотам.

Что проверить:
- ключ вставлен в правильное поле;
- YouTube Data API v3 включён в Google Cloud проекте;
- ключ не ограничен неправильным API;
- дневная квота не закончилась;
- ключей достаточно: обычно лучше иметь несколько ключей, от 7 и больше;
- ключи из разных Google Cloud проектов могут дать больше суммарной квоты.
Ошибки YouTube OAuth
OAuth нужен для загрузки видео. Если YouTube upload не работает, проблема может быть не в API key, а в авторизации канала.

Проверьте:
- загружен ли
client_secrets.json; - выбран ли правильный канал при авторизации;
- не отозван ли доступ в Google аккаунте;
- добавлен ли email в test users, если OAuth-приложение в тестовом режиме;
- есть ли финальный
.mp4и обложка; - не запрещает ли YouTube custom thumbnail для неподтверждённого канала.
Ошибки WordPress
Если WordPress не принимает статью, чаще всего проблема в URL, логине, Application Password или REST API.

Частые причины:
- URL без
https://; - неверный Application Password;
- пользователь не имеет прав автора/редактора/админа;
- REST API закрыт плагином безопасности;
- Cloudflare/firewall блокирует запрос;
- сайт требует Basic Auth;
- изображения слишком большие для хостинга.
Генерация текста дала плохой результат
Если сценарий не нравится, не запускайте десятки перегенераций вслепую. Лучше исправить причину.

Что проверить:
- описание канала в Quick Setup;
- результаты AI-конфигуратора;
- промпты Шага 1;
- включён ли Fact-check для чувствительных тем;
- включён ли Humanizer, если текст выглядит слишком машинным;
- Prompt History, чтобы вернуть удачную версию промпта.
Голос звучит неправильно
Проблема может быть в шаблоне голоса, провайдере, скорости, словаре произношения или пост-обработке.

Что сделать:
- проверьте выбранный шаблон ElevenLabs/Lumean;
- прослушайте короткий тест;
- уменьшите скорость, если диктор торопится;
- добавьте сложные слова в словарь произношения;
- временно отключите Anti-Detect аудио, если оно портит звук;
- перегенерируйте только озвучку, а не весь ролик.
Изображения или видео выглядят плохо
Если кадры не соответствуют стилю, персонаж меняется или AI-видео морфит объекты, сначала исправляйте промпты и настройки, а не запускайте полный цикл заново.

Проверьте:
- настройки персонажа;
- YouMind Skill и визуальный стиль;
- негативный промпт;
- количество кадров/клипов;
- анимационный промпт Шага 4;
- запреты на morphing, distortion, extra objects;
- Prompt History для отката промпта.
Builder не собрал финальное видео
Builder зависит от материалов предыдущих шагов. Если финального .mp4 нет, проверьте входные файлы.

Проверьте:
- есть ли голосовая дорожка;
- есть ли изображения;
- включён ли Builder;
- не выбран ли слишком дорогой/тяжёлый режим;
- хватает ли FX;
- нет ли ошибки на субтитрах, музыке, аватаре или плашках;
- появился ли файл в Файлах проекта после завершения.
Не нажимайте запуск много раз подряд
Если задача уже запущена, повторные клики могут создать лишние операции, hold и расходы.

Правильное поведение:
- Нажали запуск один раз.
- Открыли Dashboard или журнал.
- Дождались статуса.
- Если ошибка — разобрали её.
- Только потом повторили запуск.
Когда обращаться в поддержку
Обращайтесь в поддержку или отправляйте отчёт, если:
- FX списались, но задача не появилась и в журнале нет понятной ошибки;
- файл не появился после успешного статуса;
- интерфейс показывает внутреннюю ошибку;
- OAuth/WordPress не работают после всех проверок;
- AI-помощник не может объяснить проблему;
- ошибка повторяется на нескольких проектах.

Перед обращением подготовьте:
- название проекта;
- какой шаг запускали;
- последние строки журнала;
- пример темы;
- скрин ошибки без секретных ключей;
- что уже пробовали сделать.
Главное правило
Почти любая проблема в FOXI диагностируется по цепочке: проект → очередь тем → журнал → баланс FX → тариф → файлы проекта → настройки шага → AI-помощник. Если идти по этому порядку, ошибка обычно находится быстрее, чем при случайных повторных запусках.