# Known Issues

Известные проблемы и ограничения пайплайна.

## Critic Mode: 3 API вызова при ошибке квоты

**Проблема**: Когда LaoZhang API возвращает ошибку квоты, critic mode всё равно делает 3 вызова вместо 1.

**Причина**: `stage2_with_critic` пробует `num_options=3` вариантов стилей последовательно. Если первый вызов падает из-за квоты, остальные 2 тоже упадут с той же ошибкой.

**Влияние**: Лишние 2 неудачных запроса к API, небольшая задержка (~2-3 сек).

**Workaround**: Пополнить баланс LaoZhang перед генерацией.

**Возможное решение**: Добавить early exit если первый вызов в цикле падает (likely API issue).

```python
# full_pipeline_v2.py, stage2_with_critic(), ~line 682
else:
    print(f"    Warning: Failed to generate vision {i}")
    # TODO: early exit if i == 0 (first call failed)
```

---

## Veo3: Нет осмысленной речи

**Проблема**: Veo3 не умеет генерировать осмысленную речь персонажей.

**Workaround**: Использовать только восклицания ("Wow!", "Mmm!", "Yeah!") или убирать звук.

---

## NanoBanana: Inconsistent faces/poses

**Проблема**: Act 1 и Act 2 могут иметь разные лица/позы персонажа.

**Workaround**: Используем `reference_image` для Act 2 с описанием consistency requirements в промпте.

---

## Sellematics: Требует SSH туннель

**Проблема**: Sellematics API доступен только через SSH туннель.

**Workaround**: Systemd service `sellematics-tunnel.service` поддерживает туннель.

```bash
sudo systemctl status sellematics-tunnel
```
